|
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.
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:
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:
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:
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:
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:
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:
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.
|