SET-SYSOUT-READ-MARK

Set read mark in SYSOUT file

Component:	SYSFILE
Functional area:	Job processing File processing
Domain:	JOB PROCEDURE PROGRAM
Privileges:	STD-PROCESSING HARDWARE-MAINTENANCE SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION

Function

The SET-SYSOUT-READ-MARK command sets a “read mark” at the current end of the SYSOUT file. Further outputs to SYSOUT are continued without interruption behind the read mark. When SYSOUT is assigned to a file, the content of the file ahead of the read mark can then be accessed in read mode without the assignment of SYSOUT having to be changed.

A read mark cannot be set if a library element or an S variable is assigned.

By default, the command applies for the SYSOUT file of the user’s own task.
Specifying a TSN or monitor JV permits nonprivileged users also to issue the command for the SYSOUT files of other tasks under their user ID.

The primary allocation and properties of SYSOUT are described in section "System files".

Privileged function

The TSOS privilege enables the command to be issued for the SYSOUT file of any task.

Format

SET-SYSOUT-READ-MARK                                                                                                                                  

JOB-IDENTIFICATION = *OWN / <alphanum-name 1..4> / *TSN(...) / *MONJV(...)
	*TSN(...)
		|	TSN = <alphanum-name 1..4>
	*MONJV(...)
		|	MONJV = <filename 1..54 without-gen-vers>

Operands

JOB-IDENTIFICATION =
Specifies the job in whose SYSOUT file the read mark is to be set. The job can be identified either via its TSN or the JV which monitors it.

JOB-IDENTIFICATION = *OWN
The command is executed for the user’s own task.

JOB-IDENTIFICATION = <alphanum-name 1..4>
TSN of the job (see also JOB-IDENTIFICATION=*TSN).

JOB-IDENTIFICATION = *TSN(...)
The job is identified by its task serial number (TSN). The command is rejected if the TSN does not exist or a job under a foreign user ID is not concerned.

TSN = <alphanum-name 1..4>
TSN of the job. Leading zeros can be omitted.

JOB-IDENTIFICATION = *MONJV(...)
This operand is only available to a user with the software product JV.
The job is identified via the monitoring JV. The command is rejected if the JV cannot be accessed (no read permission or the JV does not exist), if the JV is not monitoring a job or if the job is running on a foreign computer.

MONJV = <filename 1..54 without-gen-vers>
Name of the JV which monitors the job.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed
	0	SSM1205	Wait time for pseudo close has expired; processing will continue
	32	SSM1201	Internal error when setting the read mark
	64	CMD0216	No authorization to execute command
	64	SSM1202	System file is empty or not assigned