Assign SYSOUT to output destination
Component: | SYSFILE |
Functional area: | Job processing |
Domain: | JOB |
Privileges: | STD-PROCESSING |
Function
The ASSIGN-SYSOUT command assigns the system output file SYSOUT to an output destination. In interactive mode, SYSOUT is assigned primarily to the terminal. If it is reassigned to a different output destination, all outputs are redirected. In addition, output may be displayed on the terminal (TERMINAL-DISPLAY operand set to *YES). If this option is not taken (TERMINAL-DISPLAY=*NO), the user’s outputs are not restored to the terminal until SYSOUT is given the assignment *PRIMARY.
The primary allocation and properties of SYSLST are described in section "System files".
Restrictions
Allocating a system file to a variable with TO=*VARIABLE(...) is only possible if the chargeable subsystem SDF-P is loaded.
Format
ASSIGN-SYSOUT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
TO =
Output destination to which SYSOUT is to be assigned.
TO = <filename 1..54>
Name for the new file or name of an existing file to which SYSOUT is to be assigned. A new file is created with the following attributes:
SAM access method
Initial allocation of the size defined by the system parameter SSMAPRI (default: 24 PAM pages).
Secondary allocation of the size defined by the system parameter SSMASEC (default: 24 PAM pages).
If an existing file is to be used, it must be a SAM file.
If no further storage space is available during SYSOUT output to a disk file, the system behaves as described in the "Notes on the behavior of the system in case of insufficient storage space".
TO = *VARIABLE(...)
Name of a complex S variable of the “list” type (i.e. a series of elements of the same variable type which can only be accessed sequentially). Complex S variables can only be used if the chargeable subsystem SDF-P is loaded (see the “SDF-P” manual [34]). The command will be rejected if the specified list has not been declared or if the list elements are not of variable type STRING (or ANY).
VARIABLE-NAME = <composed-name 1..254>
Name of the S variable.
TO = *LIBRARY-ELEMENT(...)
Output to a PLAM library element.
If no further storage space is available during SYSOUT output to a disk file, the system behaves as described in the "Notes on the behavior of the system in case of insufficient storage space".
LIBRARY = <filename 1..54 without-gen-vers>
Name of a PLAM library.
ELEMENT = <composed-name 1..64 with-under>(...)
Name of an element in the specified library.
VERSION = *UPPER-LIMIT / <composed-name 1..24>
Addition of the version to the element name. The default value is the highest possible version of the specified element.
TYPE = P / *STD / <alphanum-name 1..8>
Type of the element. The *STD operand value corresponds to element type P.
P | Element type P (print-edited data); default value |
S | Element type S (source program) |
D | Element type D (text data) |
M | Element type M (macro) |
TO = *PRIMARY
Resets SYSOUT to its primary assignment (see section "System files").
TO = *DUMMY
Assigns SYSOUT to a dummy file, which means that output to a volume is suppressed. For further information on using dummy files see the FILE-NAME=*DUMMY operand in the ADD-FILE-LINK command description.
OPEN-MODE = *OUTPUT / *EXTEND
Specifies whether an already cataloged SAM file is to be replaced or extended. If a complex S variable is assigned: If OPEN-MODE=*OUTPUT is specified, output resumes with the first list element. Previous list items can no longer be accessed. If OPEN-MODE=*EXTEND is specified, the list of variables is extended (dynamic extension must have been permitted).
TERMINAL-DISPLAY = *NO / *YES
Specifies whether output to SYSOUT should also be displayed on the terminal. This operand is allowed only in interactive mode. If SYSOUT has its primary assignment, the operand is ignored.
CODED-CHARACTER-SET = *TASK-TYPE-DEFAULT / *NONE / <name 1..8>
Determines the code of the SYSOUT file. This defines how the characters of a national character set are to be stored in binary form. The defined character set affects, for example, the screen display of the characters, the sort sequence (see the “XHCS” User Guide [51]).
CODED-CHARACTER-SET = *TASK-TYPE-DEFAULT
The code defined for the SYSOUT file depends on the task mode:
No code table is used within a batch task (corresponds to CODED-CHARACTER-SET=*NONE).
The code table currently set for the task is used within an interactive task (see also the function description of the MODIFY-TERMINAL-OPTIONS command).
CODED-CHARACTER-SET = *NONE
No code is defined for the SYSOUT file.
CODED-CHARACTER-SET = <name 1..8>
The specified code is defined for the SYSOUT file.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed | |
1 | 0 | SSM2039 | Command executed but error occurred on closing the previously assigned SYSLST file (DMS error is contained as an insert in the SYSOUT message) |
2 | 0 | SSM3200 | Command executed with a warning |
2 | 0 | SSM3034 | The system file is already assigned to *PRIMARY |
1 | SSM2036 | Operand invalid | |
1 | SSM2038 | The specified code table (CCS) is not permitted | |
32 | SSM1013 | System error during command execution | |
64 | SSM2012 | OPEN error on output (DMS error is contained as an insert in the SYSOUT message) | |
64 | SSM2048 | XHCS does not support the specified code table (CCS) | |
64 | SSM2061 | Error on accessing PLAM library element | |
64 | SSM2064 | System file cannot be assigned via RFA | |
64 | SSM3031 | Semantic error | |
64 | SSM3055 | Invalid record or file format | |
64 | SSM3100 | S variable does not exist | |
64 | SSM3101 | S variable not of list type | |
64 | SSM3102 | SDF-P subsystem not available | |
64 | SSM3200 | Error on accessing PLAM library or element |
Notes on the behavior of the system in case of insufficient storage space
If there is insufficient storage space during the output to the system file SYSLST (not SYSLST01 to SYSLST99) or SYSOUT, the system behaves as follows:
In case of assignment to the temporary S.LST or S.OUT file (*PRIMARY):
If the system parameter is SSMPNOQ=YES (default setting), the logging is terminated (implicit assignment of the system file on *DUMMY). The task issues the console message SSM2076 and continues to run normally.
If SSMPNOQ=NO, the temporary file is treated as a permanent file (see below).
In case of assignment to a permanent disk file or a library element in an interactive task:
In interactive mode the system asks the user (message SSM2035 or SSM2078) how to proceed further. The user has the following response options:
N
Closes the assigned file or the library element and changes the system file assignment to the dummy file *DUMMY (thereby losing further outputs!).
P
Closes the assigned file or the library element and changes the system file assignment to the primary assignment *PRIMARY.
T
Requests a tape (volume type TAPE) to continue the output. From there on, the process is the same as in a batch task (see below).
M
Has the same effect as T, but the requested volume type is taken from the SSMSDEVD system parameter (default setting: TAPE-C4).
In case of assignment to a permanent disk file or a library element in a batch task:
If the system parameter is SSMSDEVB=*DUMMY, the system file assignment is changed to *DUMMY and the previously used file or library element is closed. The task issues the console message SSM2076 and continues to run normally.
If not, the system requests a tape with the volume type from the SSMSDEVB system parameter (default setting: TAPE). If it receives this tape, e.g. via an automatic assignment by MAREN, the disk file or library element is copied to it and subsequently deleted. The output is then continued in the tape file.
The Name of the file on tape or MTC is the name of the disk file.
The name of the library element on tape or MTC isS.OUT.PLAM-TO-TAPE.<tsn>.<date>.<time>.<tsn>=
The task’s TSN
<date>=
Creation date in the format yyyy-mm-dd, with yyyy=year, mm=month and dd=day
<time>=
Creation time in the format hhmmss, with hh=hours, mm=minutes and ss=seconds
If, however, MAREN reports that there are no free volumes of the requested type, the system file assignment is changed to *PRIMARY (or to *DUMMY, if it already was *PRIMARY). The task issues the console message SSM2076 and continues to run normally.
Without MAREN the tape request will lead to the console query DMS0591. The task waits until the operator manually assigns a tape or rejects the assignment. In case of a rejection, the operator receives the question SSM3060, which has the same possible answers as the dialog question SSM2035 (see above).
Example
The ENTER file E.ENTER contains the following records:
/SET-LOGON-PAR /ASS-SYSOUT TO=L.PROT /SHOW-SYS-FILE SYSTEM-FILE=*SYSOUT /ASS-SYSOUT TO=*PRIMARY /SHOW-SYS-STAT /EXIT-JOB
Calling the ENTER file:
/enter-job from-file=e.enter,cpu-limit=19
% JMS0066 JOB '(NONE)' ACCEPTED ON 04-12-16 AT 14:55, TSN = 6VCN
During ENTER file execution the following records of the SYSOUT log are output
on the printer:
/SET-LOGON-PAR %.... /ASS-SYSOUT TO=L.PROT /SHOW-SYS-STAT % SCP1095 DPRINTSV WARNING : SOME DPRINT PRINT-JOBS CANNOT BE DISPLAYED % T1 T2 T3 T4PR T4FD T4TP T5AC T5KP T6 T7 T8 % 0 1 1 6 0 0 0 0 0 0 0 /EXIT-JOB %....
to the file L.PROT:
/SHOW-SYS-FILE SYSTEM-FILE=SYSOUT PROCEDURE LEVEL NUMBER 0 SYSOUT : :2OSG:$USER1.L.PROT /ASS-SYSOUT TO=*PRIMARY