SET-SYSLST-READ-MARK

Set read mark in SYSLST 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-SYSLST-READ-MARK command sets a “read mark” at the current end of the SYSLST file. Further outputs to SYSLST are continued without interruption behind the read mark. When SYSLST 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 SYSLST 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 SYSLST file of the user’s own task. The read mark can also be set in files which are assigned to the system files SYSLST01 through SYSLST99.
Specifying a TSN or monitor JV permits nonprivileged users also to issue the command for the SYSLST files of other tasks under their user ID.

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

Privileged function

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

Format

SET-SYSLST-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>
,SYSLST-NUMBER = *STD / <integer 1..99>

Operands

JOB-IDENTIFICATION =
Specifies the job in whose SYSLST 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.

SYSLST-NUMBER = *STD / <integer 1..99>
Specifies the SYSLST file for which the read mark is to be set. *STD presets the system file SYSLST. The specification <integer 1..99> sets the read mark in the file which is assigned to the system file SYSLST01 through SYSLST99.

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