Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-SYSTEM-FILE-ASSIGNMENTS

&pagelevel(3)&pagelevel

Display information on system files

Component:

SYSFILE                                                                                                         

Functional area:

Job processing File processing

Domain:

JOB
PROGRAM
FILE
PROCEDURE

Privileges:

STD-PROCESSING
HARDWARE-MAINTENANCE
SAT-FILE-EVALUATION
SAT-FILE-MANAGEMENT
SECURITY-ADMINISTRATION

Function

The SHOW-SYSTEM-FILE-ASSIGNMENTS command displays the current assignments of the system files and of the module file TASKLIB for the user’s own task. Optionally a nonprivileged user can request this information for every task which executes under his/her user ID (JOB-IDENTIFICATION=*TSN operand).

The assignments refer to the procedure level on which the command is entered (see "Output Format").

The command supports structured output in S variables (see "Output in S Variable").

Privileged functions

The command supplies the systems support staff (privilege TSOS) with all information about a single job started under any user ID.

Format

SHOW-SYSTEM-FILE-ASSIGNMENTS                                                                      

Alias: SHSFA

SYSTEM-FILE = *ALL / *SYSLST-NUMBER(...) /

list-poss(5): *SYSCMD / *SYSDTA / *SYSLST / *SYSOUT / *TASKLIB


*SYSLST-NUMBER(...)



|

NUMBER = <integer 1..99>

,JOB-IDENTIFICATION = *OWN / <alphanum-name 1..4> / *TSN(...)


*TSN(...)



|

TSN = <alphanum-name 1..4>

Operands

SYSTEM-FILE = *ALL / *SYSLST-NUMBER(...) / list-poss(5): *SYSCMD / *SYSDTA / *SYSLST / *SYSOUT / *TASKLIB
Name of the desired system file.

SYSTEM-FILE = *ALL
All system files.

SYSTEM-FILE = *SYSLST-NUMBER(...)
SYSLST files from the series SYSLST01 to SYSLST99.

NUMBER = <integer 1..99>
Number of the SYSLST file.

JOB-IDENTIFICATION = *OWN / <alphanum-name 1..4>
Specifies the task for which the current assignment of the system files is to be displayed.

JOB-IDENTIFICATION = *OWN
Displays the current assignment for the user’s own task.

JOB-IDENTIFICATION = <alphanum-name 1..4>
TSN of the task for which the current assignment is to be displayed (see also JOB-IDENTIFICATION=*TSN). The nonprivileged caller can only specify tasks which run under his/her own user ID.

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

TSN = <alphanum-name 1..4>
TSN of the task for which the current assignment is to be specified. Leading zeros may be omitted The nonprivileged caller can only specify tasks which run under his/her own user ID.

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

Command executed


1

SSM2036

Syntax error


1

SSM1206

TSN not found or command processing illegal


1

SSM1013

System error


1

CMD0216

Requested privilege missing


64

SSM1209

Wait time expired (if JOB-ID not equal *OWN)

Output format

The user receives the following display:

PROCEDURE LEVEL NUMBER i
TSN            :  tsn
system file 1  :  assignment
   .               .
   .               .
   .               .
system file n  : assignment

where:

i=

current level number of the (nested) procedure;
i=0 means: primary command input (no procedure)

tsn                    

TSN of the task for which the information in the JOB-IDENTIFICATION operand was requested explicitly. This information line is omitted in the case of JOB-ID=*OWN.

system file 1,...
system file n

system files corresponding to the operand specifications

assignment

current assignment at the specified procedure level (i=0 indicates primary command input)

The following assignments may be output:

System file

Possible assignment and explanation

SYSCMD

(PRIMARY)

Primary assignment, see section "System files"

*PRIMARY (DIALOG-BLOCK)

Input is effected from a dialog block (see the “SDF-P” manual [34])

filename

Path name for the procedure file of the called non-S procedure; if called with ENTER-PROCEDURE, path name of the S.PROC. file

filename (PROCEDURE)

Path name for the procedure file of the S procedure called by CALL-PROCEDURE;
if called with ENTER-PROCEDURE, path name of the S.PROC. file

filename (INCLUDE)

Path name for the procedure file of the S procedure called by INCLUDE-PROCEDURE

*VAR(s-variable) (PROCEDURE)

Name of an S variable of the list type in which the S procedure called by CALL-PROCEDURE is stored

*VAR(s-variable) (INCLUDE)

Name of an S variable of the list type in which the S procedure called by INCLUDE-PROCEDURE is stored

*LIB-ELEM(library,element(version)) (PROCEDURE)

Name of the PLAM library and the element containing the S procedure called by CALL-PROCEDURE

*LIB-ELEM(library,element(version)) (INCLUDE)

Name of the PLAM library and the element containing the S procedure called by INCLUDE-PROCEDURE

SYSDTA

(PRIMARY)

Primary assignment, see section "System files"

(SYSCMD)

The SYSCMD system file assignment applies.

filename

Path name of the assigned file

*LIB-ELEM(library,element(version),type)

A PLAM library element is assigned. Library name, element name, version and element type are displayed

*VAR(s-variable)

An S variable (list type) is assigned

SYSIPT

This system file is still available for reasons of compatibility, but it is not described.

SYSOUT

(PRIMARY)

Primary assignment, see section "System files"

*DUMMY

A dummy file is assigned (see ADD-FILE-LINK command)

filename

Path name of the assigned file

*VAR(s-variable)

An S variable (list type) is assigned

*LIB-ELEM(library,element(version),type)

A PLAM library element is assigned. Library name, element name, version and element type are displayed

SYSLST

(PRIMARY)

Primary assignment, see section "System files"

*DUMMY

A dummy file is assigned (see ADD-FILE-LINK command)

filename

Path name of the assigned file

*VAR(s-variable)

An S variable (list type) is assigned

*LIB-ELEM(library,element(version),type)

A PLAM library element is assigned. Library name, element name, version and element type are displayed

SYSLSTnn

*SYSLSTmm

A system file SYSLSTmm is assigned, where mm not equal nn.

*DUMMY

A dummy file is assigned (see ADD-FILE-LINK command)

filename

Path name of the assigned file

*VAR(s-variable)

An S variable (list type) is assigned

SYSOPT

This system file is still available for reasons of compatibility, but it is not described.

TASKLIB

filename

Path name of the assigned object module library

Output in S variables

The command's SYSTEM-FILE operand identifies the S variables which are to be created. The following specifications are possible for SYSTEM-FILE:

Notation used in command

Abbreviated form used in table

SYSTEM-FILE=*ALL

1

SYSTEM-FILE=*SYSCMD

2

SYSTEM-FILE=*SYSDTA

3

SYSTEM-FILE=*SYSLST

4

SYSTEM-FILE=*SYSOUT

5

SYSTEM-FILE=*TASKLIB

6

SYSTEM-FILE=*SYSLST-NUMBER(xy) with xy=01..99

7

SYSTEM-FILE=*ALL and the assignment of SYSLSTxy is not *PRIMARY

8

There is a supplementary condition set by the var(*LIST).SYSxxx.ASS-TYPE S variable. Only for particular contents of this S variable are S variables generated in the same structure
(e.g. var(*LIST).SYSxxx.ELEM or var(*LIST).SYSxxx.F-NAME).

Supplementary conditions:

Notation used in command

Abbreviated form used in table

var(*LIST).SYSxxx.ASS-TYPE=*LIB-ELEM

a

var(*LIST).SYSxxx.ASS-TYPE=*FILE

b

var(*LIST).SYSxxx.ASS-TYPE=*VAR

c

var(*LIST).SYSLSTnn.ASS-TYPE=*SYSLST

d

Output information

Name of the S variable                      

T

Contents                     

Condition

Current level number of the (nested) procedure

var(*LIST).PROC-LEV-NUM

I

<integer 0..nn>


Current assignment of the SYSCMD system file

var(*LIST).SYSCMD.ASS-TYPE

S

*DIALOG-BLOCK
*FILE
*LIB-ELEM
*PRIMARY
*VAR

1,2

Name of the element assigned to SYSCMD

var(*LIST).SYSCMD.ELEM

S

<comp.-name 1..64>

1,2 a

Type of element assigned to SYSCMD

var(*LIST).SYSCMD.ELEM-TYPE

S

<alphan.-name 1..8>

1,2 a

Version of the element assigned to SYSCMD

var(*LIST).SYSCMD.ELEM-VERSION

S

<comp.-name 1..24>

1,2 a

Path name of the file assigned to SYSCMD

var(*LIST).SYSCMD.F-NAME

S

<filename 1..54>

1,2 b

Name of the PLAM library assigned to SYSCMD

var(*LIST).SYSCMD.LIB

S

<filename 1..54>

1,2 a

Name of the S variable assigned to SYSCMD

var(*LIST).SYSCMD.VAR-NAME

S

<comp.-name 1..255>

1,2 c

Current assignment of the SYSDTA system file

var(*LIST).SYSDTA.ASS-TYPE

S

*FILE
*LIB-ELEM
*PRIMARY
*SYSCMD
*VAR

1,3

Name of the element assigned to SYSDTA

var(*LIST).SYSDTA.ELEM

S

<comp.-name 1..64>

1,3 a

Type of element assigned to SYSDTA

var(*LIST).SYSDTA.ELEM-TYPE

S

<alphan.-name 1..8>

1,3 a

Version of the element assigned to SYSDTA

var(*LIST).SYSDTA.ELEM-VERSION

S

<comp.-name 1..24>

1,3 a

Path name of the file assigned to SYSDTA

var(*LIST).SYSDTA.F-NAME

S

<filename 1..54>

1,3 b

Name of the PLAM library assigned to SYSDTA

var(*LIST).SYSDTA.LIB

S

<filename 1..54>

1,3 a

Name of the S variable assigned to SYSDTA

var(*LIST).SYSDTA.VAR-NAME

S

<comp.-name 1..255>

1,3 c

Output only for reasons of compatibility

var(*LIST).SYSIPT.ASS-TYPE

S

*FILE
*NOT-ASS
*SYSCMD

1

Output only for reasons of compatibility

var(*LIST).SYSIPT.F-NAME

S

<filename 1..54>

1b

Current assignment of the SYSLST system file

var(*LIST).SYSLST.ASS-TYPE

S

*DUMMY
*FILE
*LIB-ELEM
*PRIMARY
*VAR

1,4

Name of the element assigned to SYSLST

var(*LIST).SYSLST.ELEM

S

<comp.-name 1..64>

1,4 a

Type of element assigned to SYSLST

var(*LIST).SYSLST.ELEM-TYPE

S

<alphan.-name 1..8>

1,4 a

Version of the element assigned to SYSLST

var(*LIST).SYSLST.ELEM-VERSION

S

<comp.-name 1..24>

1,4 a

Path name of the file assigned to SYSLST

var(*LIST).SYSLST.F-NAME

S

<filename 1..54>

1,4 b

Name of the PLAM library assigned to SYSLST

var(*LIST).SYSLST.LIB

S

<filename 1..54>

1,4 a

Name of the S variable assigned to SYSLST

var(*LIST).SYSLST.VAR-NAME

S

<comp.-name 1..255>

1,4 c

Current assignment of system file SYSLSTnn (where nn = 01...99)

var(*LIST).SYSLSTnn.ASS-TYPE

S

*DUMMY
*FILE
*LIB-ELEM
*PRIMARY
*SYSLST
*VAR

7,8

Name of the element assigned to SYSLSTnn (where nn = 01...99)

var(*LIST).SYSLSTnn.ELEM

S

<comp.-name 1..64>

1,7 a

Type of element assigned to SYSLSTnn (where nn = 01...99)

var(*LIST).SYSLSTnn.ELEM-TYPE

S

<alphan.-name 1..8>

1,7 a

Version of the element assigned to SYSLSTnn (where nn = 01...99)

var(*LIST).SYSLSTnn.ELEM-VERSION

S

<comp.-name 1..24>

1,7 a

Path name of the file assigned to SYSLSTnn (where nn = 01...99)

var(*LIST).SYSLSTnn.F-NAME

S

<filename 1..54>

1,7 b

Name of the PLAM library assigned to SYSLSTnn (where nn = 01...99)

var(*LIST).SYSLSTnn.LIB

S

<filename 1..54> 

1,7 a

Number of the SYSLST file which is assigned to SYSLSTnn (when nn = 01...99, but is not equal to the number)

var(*LIST).SYSLSTnn.SYSLST-NUM

S

<integer 0..99>

1,7 d

Name of the S variable assigned to SYSLSTnn (where nn = 01...99)

var(*LIST).SYSLSTnn.VAR-NAME

S

<comp.-name 1..255>

1,7c

Output only for reasons of compatibility

var(*LIST).SYSOPT.ASS-TYPE

S

*DUMMY
*FILE
*PRIMARY

1

Output only for reasons of compatibility

var(*LIST).SYSOPT.F-NAME

S

<filename 1..54>

1 b

Current assignment of the SYSOUT system file

var(*LIST).SYSOUT.ASS-TYPE

S

*DUMMY
*FILE
*LIB-ELEM
*PRIMARY
*VAR

1,5

Name of the element assigned to SYSOUT

var(*LIST).SYSOUT.ELEM

S

<comp.-name 1..64>

1,5 a

Type of element assigned to SYSOUT

var(*LIST).SYSOUT.ELEM-TYPE

S

<alphan.-name 1..8>

1,5 a

Version of the element assigned to SYSOUT

var(*LIST).SYSOUT.ELEM-VERSION

S

<comp.-name 1..24>

1,5 a

Path name of the file assigned to SYSOUT

var(*LIST).SYSOUT.F-NAME

S

<filename 1..54>

1,5 b

Name of the PLAM library assigned to SYSOUT

var(*LIST).SYSOUT.LIB

S

<filename 1..54>

1,5 a

Name of the S variable assigned to SYSOUT

var(*LIST).SYSOUT.VAR-NAME

S

<comp.-name 1..255>

1,5 c

Current assignment of the TASKLIB object module file

var(*LIST).TASKLIB.ASS-TYPE

S

*FILE
*PRIMARY

1,6

Path name of the object module file assigned to TASKLIB

var(*LIST).TASKLIB.F-NAME

S

<filename 1..54>

1,6 b

Examples

Output in S variables

/declare-var var-name=var(type=*structure),multiple-elem=*list
/assign-syslst to=*var(library=plamlib1,element=lst.file.1)
/exec-cmd (show-system-file-ass system-file=*syslst),
           text-output=*none,structure-output=var
/show-var var,inf=*par(val=*c-literal)

VAR#1.PROC-LEV-NUM = 0
VAR#1.SYSLST.ASS-TYPE = '*LIB-ELEM'
VAR#1.SYSLST.LIB = ':2OSG:$USER1.PLAMLIB1'
VAR#1.SYSLST.ELEM = 'LST.FILE.1'
VAR#1.SYSLST.ELEM-VERSION = '*UPPER-LIMIT'
VAR#1.SYSLST.ELEM-TYPE = 'P'
*END-OF-VAR
Output to SYSOUT

/show-sys-file ——————————————————————————————————————————————————————— (1) 

%PROCEDURE LEVEL NUMBER 0
%SYSCMD  : (PRIMARY)
%SYSDTA  : (PRIMARY)
%SYSIPT  : NOT ASSIGNED
%SYSOUT  : (PRIMARY)
%SYSLST  : (PRIMARY)
%SYSOPT  : (PRIMARY)
%TASKLIB : (PRIMARY)

/call-proc proc.test1 ———————————————————————————————————————————————— (2) 

.
.
. [K2]
.
.
%  CMD0170 DO YOU WANT TO INSERT COMMANDS? REPLY (Y=YES; N=NO)?y
%  SSM2014 TASK IN ESCAPE MODE AT LEVEL NUMBER '1'

/show-sys-file —————————————————————————————————————————————————————— (3) 

%PROCEDURE LEVEL NUMBER 1
%SYSCMD  : :N:$USERXY01.PROC.TEST1 (PROCEDURE)
%SYSDTA  : (SYSCMD)
%SYSIPT  : NOT ASSIGNED
%SYSOUT  : (PRIMARY)
%SYSLST  : (PRIMARY)
%SYSOPT  : (PRIMARY)
%TASKLIB : (PRIMARY)

(1)

Information on the assignment of system files for the dialog task.

(2)

Calling procedure PROC.TEST1. Interrupting procedure execution with [K2].

(3)

Information on the assignment of system files for the dialog task on procedure level 1. The system file SYSCMD is assigned to procedure file PROC.TEST1.

Powered by Atlassian Confluence and Scroll Viewport.