Restarting devices *RESTART,devname

Function

Use the *RESTART,devname command to:

Resume writer activity
Respecify the forms, carriage tape (FCB), band or train (UCS) , or all currently assigned to the output device while starting or restarting writer activity
Reassign writer characteristics for the 3800 printer while starting or restarting writer activity
Specify the non-process-run-out (NPRO) interval for the writer command
Reassign the header or burst record designations
Reassign the writer-selection characteristics
Reassign the output classes that the writer can process
Specify the process modes that the writer can select
Reassign the number of output lines or pages allowed per unit of work
Specify the number of pages that JES3 writes or the number of seconds that elapse before a checkpoint is taken
Specify that you want vertical separator lines printed on the edges of output
Respecify the action to be taken at the beginning of each output data set
Determine the current page or record position of a data set being processed by a writer
Alter the number of copies of the currently active data set to be produced and to commence writer activity
Turn on the diagnostic mode and to start writer activity
Space the current copy of the current data set forward or backward a prescribed number of lines or pages, and to restart writer activity
Reload the FCB and UCS/CHARS buffer on applicable writers
Place the current data set in hold status and commence printing another data set
Print in single-space mode from the beginning of the data set, or to resume printing with American National Standard control characters or machine carriage control from the beginning of the data set (if program control was specified for the data set)
Respecify the destination for the current output
Restart a writer and then automatically end the writer when it completes the current request
End a writer immediately after rescheduling all the completed (printed) data sets for the job
Restart WTR and reset the output service diagnostic mode
Note: For a 3800 printer, the display includes the number of pages remaining in the printer's buffer for all data sets that had been sent to the printer at the time you entered the command. This count can include data sets from more than one job. If the copy of the data set that is visible at the transfer station fills the entire buffer and more records remain to be sent to the printer, the display includes a second count: the approximate number of records remaining to be sent. For a 3800 printer, the current output is the output that is visible at the transfer station.
For a 3800 printer running in FSS mode, the approximate number of pages and records remaining for the data set visible at the transfer station is displayed.

The C and N parameters are only valid on the *RESTART,devname command. Use the *RESTART,devname command with the appropriate parameter to stop print or punch activity for the current data set and to immediately restart activity at a prior point in the job. The current data set on a printer is the data set that is visible at the operator orientation point (OOP). On a 3800 printer, the OOP is located slightly above the transfer station.

Syntax

Parameters

devnum or /devnum or devname or J=jobno

Specifies the output device or the job number assigned to the writer DSP by the *CALL,WTR command or by JES3 in the case of a dynamic writer. Always use the JNAME of a device when selecting devices that are not directly connected to a channel.

The device number (devnum or /devnum) can be a 3-digit or 4-digit hexadecimal number. A slash (/) preceding the device number is not required. Device numbers can be specified by any of the following formats:

ddd
dddd
/ddd
/dddd

where ddd and dddd represent the device numbers.

A

Specifies automatic mode. Output continues to be processed by this writer if work is available. Automatic mode is assumed on any device operating in FSS mode except for a 3800 printer.

M

Specifies manual mode. An *START,devname command is required for the writer to continue (see Starting or restarting a writer).

When you specify manual mode for a 3800 printer, there is typically a delay between the time the *START command is issued and the time the data set appears on the paper. These delays can significantly increase the overall time required to process jobs that call for 3800 printer output. You can also specify manual mode for 3800 printers running in FSS mode. Consult your system programmer before using this option.

B=Y or N

Specifies that a burst record (job trailer) is to be placed behind each job (Y) or that the burst record option is to be suspended (N).

B=,M

Specifies that the edges of the burst page, or blank pages following a job's output, are to be marked for ease of separation. This parameter is valid only for page-oriented devices.

B=,/M

Specifies that form-marking is to be turned off.

C

Specifies restarting print or punch activity from the last checkpoint taken for the current data set.

The frequency with which checkpoints are taken is specified by the CKPNT parameter on the DEVICE initialization statement. The actual frequency with which checkpoints are taken is approximately the value specified by CKPNT (CKPNTPG or CKPNTSEC for FSS-supported devices) but is never more than twice the specification. For example, if the default for the 1403 is used (1000 records), a restart would cause printing to resume between 1000 and 2000 records before the current position. Because they are buffered devices, the printed output on remote writers might be misleading; the record count includes data that has been transferred to the buffer but not yet printed. If a restart with repositioning has been performed, the checkpoint intervals might not be on even boundaries.

If no valid checkpoint exists for the restarted data set, printing or punching resumes at the start of the current copy of the current data set.

G

Specifies that all data sets for the current job that were processed by the restarted device are to be printed. JES3 does not requeue spinoff data sets. JES3 does not requeue data sets which have an output disposition of LEAVE after processing.

J

Specifies that JES3 requeue all completed data sets of the appropriate type (that is, PRT or PUN) for the current job. JES3 does not requeue spinoff data sets. JES3 does not requeue data sets which have an output disposition of LEAVE after processing.

N

Specifies to restart printing of the current data set at the last internally-noted checkpoint (100 to 200 lines or records). If there is no internally-noted checkpoint, printing resumes at the last checkpoint or, if there is no checkpoint, at the beginning of the data set. This parameter is not valid for TSO/E writers. For a 3800 printer, N is treated as if C were specified (internally-noted checkpoints are not used).

CH

Specifies the reassigned character arrangement tables. No more than four table names can be specified. H specifies that this character arrangement table is to be used until you change it. R specifies JES3 may request a different table.

CK=nnnn P or S

Specifies the number of pages (P) that will be written or the number of seconds (S) that elapse before a checkpoint is taken. This parameter is valid only for a printer running in FSS mode.

Use the CK=keyword on *START,devname or *RESTART,devname command to specify the number of pages that JES3 writes or the number of seconds that elapse before a checkpoint is taken. You can issue this command while the writer is active. The current activity continues and the new checkpoint interval takes effect when the writer selects it next work.

MK=

C: Specifies that you want copy marks printed on a data set copy basis. For multiple copies of a data set, JES3 increments the thickness of the copy mark after each copy.
J: Specifies that you want copy marks printed on a job basis.
N: Specifies that you do not want to use copy marks. Although JES3 continues to print a vertical line on the edges of output from IBM® 3800 printers, the thickness does not vary.

CP=nnn or +nnn or -nnn

Specifies the new copy count by the actual number (1 to 255) of copies required (nnn), as an increase over the current copy count by the specified amount (+nnn), or as a decrease over the current amount by the specified amount (-nnn).

For a 3800 printer: If copy grouping is in effect for the currently active data set, a replacement, increase or decrease in the copy count affects the current copy group or groups.

CT=STANDARD,H or ,R or carr,H or ,R

Specifies the carriage tape (FCB) name. Specify STANDARD for the installation-defined standard carriage tape. H specifies that only the designated carriage tape is to be used until you change this status. R specifies that JES3 can request that a different carriage tape be placed on this device.

F=STANDARD,H or ,R or form,H or ,R

Specifies the form name. Specify STANDARD for the installation-defined standard form. H specifies that only designated forms are to be used until you change this status. R specifies that JES3 can request that different forms be placed on this device.

U=STANDARD,H or ,R or train,H or ,R

Specifies the band or train (UCS) name. Specify STANDARD for the installation-defined standard band or train. H specifies that only the designated band or train is to be used until you change this status. R specifies that JES3 can request that a different band or train be placed on this device.

D

Specifies that the diagnostic mode is to be turned on. This causes message IAT7006 to be issued for each data set selected for processing. In addition, message IAT7060 is issued when *CALL, *START, *RESTART, and *CANCEL commands are processed. The diagnostic mode remains active until it is reset. See z/OS JES3 Diagnosis for a description of the data displayed during diagnostic mode.

/D

Specifies that the diagnostic mode is to be reset (turned off).

D=devname or devnum or /devnum or (PRT or PUN,group)

Specifies the new device to which output is to be sent (devname or devnum). The type of device to receive the output is specified as PRT for any printer or PUN for any punch. The group of devices (group) to which the device has been assigned typically refers to a physical location, such as FLOOR1 or LOCAL.

The device number (devnum or /devnum) can be a 3-digit or 4-digit hexadecimal device number. A slash (/) preceding the device number is not required. Device numbers can be specified by any of the following formats:

ddd
dddd
/ddd
/dddd

where ddd and dddd represent the device numbers.

H=Y or N

Specifies that a job header record is to precede the job and a data set header record is to be placed in front of each output data set (Y) or that the header record option is to be suspended (N).

FL=

Specifies the reassigned flash id (form overlay frame). H specifies that only designated flash is to be used on the device until you change this status. R specifies that JES3 may request that a different flash be placed on this device. NONE specifies that no flash is designated for this writer.

HOLD

Specifies that activity on the current data set be suspended and that the data set be placed in hold status (as in H=Y).

L

Specifies that the FCB and UCS/CHARS buffer be reloaded. This parameter can be used alone or with other parameters. The printer will restart based upon the specification of other parameters.

L=nnnnnnnn+

Specifies the maximum number of lines (nnnnnnnn) a unit of work can have to be selected for output processing on this writer: only units of work at or below this maximum count are selected. Specifying nnnnnnnn+ indicates the minimum number of lines a unit of work can have: only units of work at or above this minimum count are selected for this writer.

NPRO=

Specifies the non-process-run-out interval. STANDARD specifies the initialization-defined value.

P

Specifies that the approximate number of pages or records remaining to be written for the current copy of the data set be displayed.

PG=nnnnnnnn+

Specifies the maximum number of pages (nnnnnnnn) a unit of work can have to be selected for output processing on this writer: only units of work at or below this maximum count are selected. Specifying nnnnnnnn+ indicates the minimum number of pages a unit of work can have: only units of work at or above this minimum count are selected for this writer.

Note: If you specify L in the work selection (WS) list and also specify (or accept the default of) PAGELIM=0 here, JES3 will not be able to select page-mode data sets for this device.

PM=/value1,/value2.... or /value

Use the PM= command to add or delete process mode values for a writer. The values specified on the DEVICE initialization statement remain in effect in addition to the new values you include on this command. You can specify up to eight process modes per writer and 255 process modes complex-wide. Use the slash to delete an existing process mode from a writer.

A writer can select only the data sets which match the process mode value specified in a user's // OUTPUT JCL statement.

Some devices are capable of operating in both FSS or compatibility mode such as the IBM 3800-3 printer. The PM= parameter affects only the process mode(s) associated with the device mode that is active at the time you enter this command.

Use the *I,D,D= command to display the process modes currently in effect for a device.

R=nnnnnnnnP or +nnnnnnnnP

Specifies that the data set be spaced forward nnnnnnnn number of lines or nnnnnnnn number of pages (P) from the start of the current copy of the current data set, or from the point in the current job specified by the C or N parameter. For a page-oriented device, you must specify the number in terms of pages (P).

If the data set is spaced forward past the end of the current copy, message IAT7006 is issued and the output writer is stopped. Spacing by page on a non-3800 printer, when pages are not defined in the data set, also causes message IAT7006 to be issued and the output writer to be stopped.

R=-nnnnnnnnP

Specifies that the data set be backspaced nnnnnnnn number of lines or nnnnnnnn number of pages (P) from the point in the job specified by the C or N parameter. This parameter has no effect unless C or N is specified. For a 3800 printer, you must specify the number nnnnnnnn in terms of pages (P).

You can backspace a 3800 printer to any page of any copy of a data set that is not yet completely stacked. If you backspace it further, the printer is repositioned to the beginning of the data set currently being stacked.

C or N

Specifies a prior point in the current data set. The forward or backward spacing requested by the R= parameter originates at this point. If C or N is not specified, forward spacing originates at the beginning of the current copy of the current data set. Backspacing is ignored unless the C or N parameter is specified.

RSCD

Specifies that the writer is to perform a scheduling pass.

S

Specifies that printing is to be in single-space mode from the beginning of the data set.

/S

Specifies that printing is to be resumed under the program control that was previously specified for the data set.

SZ=(xx,yy)

Specifies the number of pages (xx) in a SNA RJP chain and the number of lines (yy) per page. If yy is zero, then a page is defined as skip to channel 1 for printers or skip to a new card for punches. If you specify SZ=, xx must be specified and cannot be zero. This parameter overrides the CHNSIZE parameter on the DEVICE initialization statement.

T

Specifies that the writer ends automatically once the current job is rescheduled.

WC=class

Specifies one or more output classes (A to Z, 0 to 9) that can be processed by this writer. The WC= parameter allows a maximum of 36 SYSOUT classes.

Note: After reassigning output class characteristics, you should issue the *R,devname,RSCD command to force the writer through a scheduling pass with the new criteria. At this point the writer will find work to process or it will end. In either case, the new characteristics will remain in effect until you respecify new ones.

WS=val

Specifies one or more writer-selection characteristics that JES3 uses when selecting output for this device. /value specifies that the characteristic prefixed with a slash (/) is not to be used as writer-selection criterion. To specify characteristics, enter the corresponding letter:

P  - data set output priority
D  - destination
T  - specific device type
F  - forms required
C  - carriage tape (FCB) required
U  - UCS or characters required
CL - output class
L  - line and page limits
FL - flash-id (forms overlay)
CM - copy modification module
SS - stacker option
PM - data set process mode

If you selected more than one characteristic, JES3 determines the importance of the characteristic by the order in which you specified them. The ones you do not select remain in the order established at initialization, or in earlier updates, and follow those that you enter in order of importance.

When Priority is Specified:

If you specify priority (P), JES3 selects the job with the highest priority that meets other selection criteria. Otherwise, JES3 selects the first job on the output service queue that meets the selection criteria.

Once a job is selected, the units of work for that job are always selected based on priority.

When Characteristics are Omitted:

For any omitted characteristics, JES3 uses the device characteristic, regardless of the data set specification. The following examples illustrate how device characteristics are used:

If the writer selection criteria does not include ‘F’ (forms), the device specifies forms=‘RED’, and the output data set calls for forms=‘BLUE’, JES3 prints the data set using the ‘RED’ forms.
If the writer selection criteria does not include ‘U’ (UCS/CHARS), the device specifies CHARS=GT20, and the data set specifies CHARS=GT15, JES3 prints the output using CHARS=GT20.

Note:

Specifying the not (/) indication has the same result as omitting a writer-selection characteristic: JES3 uses the device characteristic for the selection criteria you remove. Following are examples of specifying a /value:
```
(1)

   *RESTART,PR1,WS=(F,C,U,/P)
 
```
This command restarts a writer for the printer named PR1 and reassigns selection based on forms, carriage tape, and UCS, regardless of output priority. All other characteristics remaining in their existing order.
```
(2)

  *RESTART,PR1,WS=(F,C,/D)
 
```
The /D negates destination checking, so a job may print at an incorrect destination.
After respecifying writer-selection characteristics, you should is sue the *R,devname,RSCD command to force the writer through a scheduling pass with the new criteria. At this point the writer will find work to process or terminate. In either case, the new characteristics will remain in effect until you respecify new ones.
If you specify (or accept the default of) PAGELIM=0 and specify L in the WS list here, JES3 will not be able to select page-mode data sets for this device.

Rules

When limits are a selection criterion, a unit of work will be selected when both line and page parameters have been satisfied, except when both criteria have been defined as minimums. In the latter case, only one of the two criteria must be met for data set selection on the writer.
Specifying line or page limit criteria overrides the LINELIM= and PAGELIM= values on the DEVICE initialization statement, or values defined on previous writer commands.
If the C or N parameter is used in conjunction with the R= parameter, forward or backward spacing takes place after the C or N parameter takes effect. When a data set on a 3800 printer is spaced forward or backward to a page within a copy group, printing resumes at the first page of the copy group.
Use the L= and PG= and SZ= keywords on the *START,devname or *RESTART,devname command to reassign the number of output lines or pages allowed per unit of work. Units of work outside the limit are not scheduled to this writer. Only subsequent units of work are scheduled accordingly.

Result

If both headers and trailers are in effect for an FSS-supported device, operator commands effecting the user's output will cause either message IAT7066 or IAT7067 to be printed on that output.