Specifying data set selection criteria for an external writer

 
F [XWTR.|jobname.]identifier,

    {{CLASS|C}=[classes]                }
                                       
    {{DEST|D}=[LOCAL                   ]}
               |remote-workstation-name 
                                       
    {{FORMS|F}=[forms-name]             }
                                       
    {{JOBID|J}=[JOBnnnnn|Jnnnnn  ]               
                |[STCnnnnn|Snnnnn]                
                |[TSUnnnnn|Tnnnnn]}                
                                       
    {{WRITER|W}=[STDWTR           ]     }
                      |user-writer-name      
 

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 for more information.

identifier

The identifier, from the START command, of the writer to be modified. (See Displaying started task status 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.
• 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, X‘0000’) 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 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= [JOB or J]nnnnn, [STC or S]nnnnn, or [TSU or T]nnnnn

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

Note:

1. JES2 ignores the prefix (JOB or J, STC or S, or TSU or T) and uses only the id number, nnnnn.
2. With JES2 operating on z/OS® version 1.2 or higher, you may specify up to a six-digit id number, or nnnnnn.

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.

CLASS=(see note),JOBID=,WRITER=,FORMS=,DEST=LOCAL

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.