SHOW-VARIABLE-CONTAINER-ATTR Display open variable containers

Domain: PROCEDURE

Command description

The SHOW-VARIABLE-CONTAINER-ATTR command displays all the open variable containers.

Format

SHOW-VARIABLE-CONTAINER-ATTR

CONTAINER-NAME = *ALL / <composed-name 1..64 with-wild(80)> / list-poss: <composed-name 1..64>

,CONTAINER-SCOPE = *VISIBLE / *PROCEDURE / *CURRENT / *TASK

,OUTPUT = *SYSOUT / *SYSLST

Operands

CONTAINER-NAME =
Name of the open variable container which is to be displayed.

CONTAINER-NAME = *ALL
All the container variables which are open are displayed.

CONTAINER-NAME = <composed-name 1..64 with-wild(80)>
All the open container variables which match the specified search pattern are displayed.

CONTAINER-NAME = list-poss: <composed-name 1..64>
List of the variable containers which are to be displayed.

CONTAINER-SCOPE =
Scope of the variable containers which are to be displayed.

CONTAINER-SCOPE = *VISIBLE
The variable containers which are displayed are those which can be accessed from the current procedure level. The current names of variable containers conceal variable containers at higher procedure levels or the task level.

CONTAINER-SCOPE = *PROCEDURE
The variable containers which are displayed are those which can be accessed from the current procedure level and which were opened with the scope PROCEDURE.

CONTAINER-SCOPE = *CURRENT
The variable containers which are displayed are those which can be accessed from the current procedure level and which were opened with the scope CURRENT.

CONTAINER-SCOPE = *TASK
Variable containers which have the scope TASK are displayed.

OUTPUT =
Address for the output information.

OUTPUT = *SYSOUT
The output information is sent to SYSOUT and/or to variables, depending on the ASSIGN-SYSOUT and ASSIGN-STREAM assignments.

OUTPUT = *SYSLST
The output information is sent to SYSLST, regardless of how the SYSINF variable stream has been assigned.

Command return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
	1	CMD0202	Syntax error
	3	CMD2203	Incorrect syntax file
	32	CMD0221	System error (internal error)
	64	CMD0216	Do not have required privilege
	64	SDP0091	Semantic error
	130	SDP0099	No further address space available

Example

Input

/OPEN-VARIABLE-CONTAINER MY-CONT1, *LIBRARY-ELEMENT(#MY-CONTAINER-LIB)
/SHOW-VARIABLE-CONTAINER-ATTR MY-CONT1

Output

CONTAINER-NAME = MY-CONT1
  FROM-FILE = *LIBRARY-ELEMENT
    LIBRARY = :1OSN:$QM123.S.152.0WDK.MY-CONTAINER-LIB
    ELEMENT = MY-CONT1
    VERSION = *HIGHEST-EXISTING
  LOCK      = *NO
  SCOPE     = *PROCEDURE

Input

/SAVE-VARIABLE-CONTAINER MY-CONT1
/CLOSE-VARIABLE-CONTAINER MY-CONT1

Structured output

To permit structured output into variables, the following operands are supported for the SHOW-VARIABLE-CONTAINER-ATTR command:

• CONTAINER-NAME (all values)

• CONTAINER-SCOPE (all values)

Further details, such as for example the conditions on the usage of individual variables, will be found in the following table.

Output structure

Output information	Name of the S variable1	T2	Contents
Name of the variable container	var#.CONTAIN-NAME	S	<comp.-name 1..64>
Name of the library element which contains the variable container	var#.FROM-F	S	*LIB-ELEM(...)
Read/write access to the library element	var#.LOCK	S	*NO *YES
Saving of the variable container at EXIT-JOB/LOGOFF (only if SCOPE=*TASK)	var#.SAVE-AT-TERM	S	*NO *YES
Scope of the variable container	var#.SCOPE	S	*INC *PROC *TASK

¹Variable names are sorted alphabetically
²The T column identifies the data types: S stands for string