F XWTR - Modify External Writer

Home Up Search Credits Site Map Contact Info. Links Disclaimer Download

Modify XWTR

Purpose:   Specifying Data Set Selection Criteria for an External Writer

You can use the MODIFY command to specify the criteria that an external writer is to use in selecting data sets for processing.

F [XWTR.|jobname.]identifier,
    {{CLASS|C}=[classes]                }
    {                                   }
    {{DEST|D}=[LOCAL                   ]}
    {          |remote-workstation-name }
    {                                   }
    {{FORMS|F}=[forms-name]             }
    {                                   }
    {{JOBID|J}=[JOBnnnn ]               }
    {      |STCnnnn                     }
    {      |TSUnnnn                     }
    {                                   }
    {{WRITER|W}=[STDWTR       ]         }
    {       |user-writer-name           }

 

F [XWTR.|jobname.]identifier,{PAUSE|P}={FORMS }
                             {DATASET}         }

 

Parameters

XWTR

The name of the IBM-supplied cataloged procedure for the external writer.

jobname

The job name assigned to the external writer.

The job name for a started task depends on whether the JOBNAME parameter was specified on the START command for the task:

If JOBNAME was specified, jobname is the name specified on the JOBNAME parameter.

If JOBNAME was not specified and the source JCL for the started task is a job, jobname is the name specified on the JCL JOB statement.

If JOBNAME was not specified and the source JCL for the started task is a procedure, jobname is the member name.

You can use asterisk notation to specify more than one job or started task on the MODIFY command. 

identifier

The identifier, from the START command, of the writer to be modified. (Refer to "Displaying Started Task Status" on page 4-147 for information about determining the jobname and identifier of currently active started tasks.)

The following types of identifiers can be used:

The identifier that was specified on the START command.

[/]devnum, the device number specified on the START or MOUNT command.

A device number is 3 or 4 hexadecimal digits, optionally preceded by a slash (/). You can precede the device number with a slash to prevent ambiguity between the device number and a device type or identifier.

v devicetype, the type of device specified on the START or MOUNT command.

If no identifier was specified, the identifier "STARTING" is temporarily assigned until the system can assign another according to the following order of precedence:

  1. 1. If an identifier was not specified on the START command, the identifier is

  2. the device type (for example, 3410) or device number (for example, X0000)

  3. specified on the START or MOUNT command.

  4. 2. If an identifier, a device type, or a device number was not specified on the

  5. START or MOUNT command, the identifier is the device type specified on

  6. an IEFRDER DD statement (invoking a cataloged procedure) in the JCL.

  7. 3. If none of the above was specified, the identifier defaults to the job name.

  8. You can use asterisk notation to specify more than one job or started task on

  9. the MODIFY command. See "Using Asterisks in MODIFY Commands" on

  10. page 4-271 for more information.

CLASS= or C=[classes]

Select only data sets enqueued in the specified classes. You can specify up to eight output classes, in priority order.

The output classes are named without separating commas. If no default class was specified in the cataloged procedure to start the external writer, and no class list is provided in the START or MODIFY command, the external writer selects any ready data set on the hard-copy queue.

JOBID= or J=JOBnnnn, STCnnnn, or TSUnnnn

Select only data sets from the job with this subsystem-assigned JOBID, where nnnn is the JOB id number or the STC id number or the TSU id number. If JOBID is omitted, the external writer does not select data sets by job.

WRITER or W=

STDWTR

Select only data sets that are to be processed by the standard (IBM-supplied) writer.

user-writer-name

Select only data sets that are to be processed by the specified user writer.

If WRITER= is specified without STDWTR or user-writer-name, the external writer does not use the writer program as a data set selection criterion and automatically invokes the correct writer programs.

FORMS= or F=[forms-name]

Select only data sets that specify this forms name.

If forms-name is omitted, the external writer does not use the forms name as a data set selection criterion, and notifies you whenever a forms change is needed.

DEST= or D=

LOCAL

Select only data sets destined for the central processor complex.

remote-workstation-name

Select only data sets destined for the specified remote workstations attached to this local complex.

If DEST= is specified without LOCAL or remote-workstation-name, the external writer does not use the destination as a data set selection criterion. 

Previously-specified options remain in effect until respecified. Before the first MODIFY command is issued, the default options are: CLASS=(see note),JOBID=,WRITER=,FORMS=,DEST=LOCAL 

Note: If no default class list is specified in the cataloged procedure to start the external writer, and you do not provide a class list in the START command, the external writer does not begin processing until you enter a MODIFY command.

The MODIFY command passes the entire command buffer, including comments, to the external writer that is to be modified. Therefore, all modifiable external writers should be sensitive to embedded blanks in their parameter fields.

Causing an External Writer to Pause

You can use the MODIFY command to cause an external writer to pause for operator intervention.

The parameters are:

XWTR

The name of the IBM-supplied cataloged procedure for the external writer.

jobname

The job name assigned to the external writer.

The job name for a started task depends on whether the JOBNAME parameter was specified on the START command for the task:

If JOBNAME was specified, jobname is the name specified on the JOBNAME parameter.

If JOBNAME was not specified and the source JCL for the started task is a job, jobname is the name specified on the JCL JOB statement.

If JOBNAME was not specified and the source JCL for the started task is a procedure, jobname is the member name.

You can use asterisk notation to specify more than one job or started task on the MODIFY command. See "Using Asterisks in MODIFY Commands" on page 4-271 for more information.

identifier

The identifier of the writer to be modified. (Refer to "Displaying Started Task Status" on page 4-147 for information about determining the job name and identifier of currently active started tasks.)

The following types of identifiers can be used:

v The identifier that was specified on the START command.

v [/]devnum, the device number specified on the START or MOUNT command.

A device number is 3 or 4 hexadecimal digits, optionally preceded by a slash (/). You can precede the device number with a slash to prevent ambiguity between the device number and a device type or identifier.

v devicetype, the type of device specified on the START or MOUNT command.

If no identifier was specified, the identifier "STARTING" is temporarily assigned until the system can assign another according to the following order of precedence:

  1. If an identifier was not specified on the START command, the identifier is the device type (for example, 3410) or device number (for example, X0000) specified on the START or MOUNT command.

  2. If an identifier, a device type, or a device number was not specified on the START or MOUNT command, the identifier is the device type specified on an IEFRDER DD statement (invoking a cataloged procedure) in the JCL.

  3. If none of the above was specified, the identifier defaults to the job name. You can use asterisk notation to specify more than one job or started task on the MODIFY command. See "Using Asterisks in MODIFY Commands" on page 4-271 for more information.

PAUSE= or P=FORMS

For unit record devices, the writer is to pause when a change of forms is necessary. The writer stops when it encounters a form name other than the installation default form name on a SYSOUT DD statement.

PAUSE= or P=DATASET

For unit record devices, the writer is to pause before starting to process each data set. When you are ready to continue processing, you can restart the writer by entering a single character response to message IEF382A.

Example 1

To stop writer 00E before it processes each new data set, enter:

F 00E,PAUSE=DATASET

Example 2

To stop writer ABCD before it processes each new data set, enter:

F /ABCD,PAUSE=DATASET

The information on this site is the combined effort of a lot of people, please credit the authors if you use their information.
Please read the Disclaimer page for the restrictions, copyright, and other uses of the information contained on this site.
For problems or questions regarding this web contact Bob.
Last updated: August 27, 2001.