DELETE and EXTRACT symbols

The JES Symbol Service uses the symbol selection list to specify symbols for the DELETE and EXTRACT operations. Each element in the selection list specifies the name of a symbol to be selected. Symbol names must be left-justified and padded by blank spaces to the specified length. Wildcard characters can be used in any element in the selection list. If the EXTRACT function does not find a JES symbol with a particular name, it will search for a JCL symbol with the same name.

The selection list is defined by the following fields:

Field Name: Description
JSYMSNMA: Pointer to a symbol selection list.
JSYMSNM#: Number of elements in the symbol selection list.
JSYMSNML: Length of each element in the selection list. Valid values for this field are 0-16 characters. A value of 0 defaults to 16 characters.

The EXTRACT operation returns a symbol table with the names and values of the symbols that were found. The output table is created in the output area provided by the caller. The layout of the symbol table is defined by the JSYTABLE data structure.

The total size of the output symbol table is returned in the JSYTLEN field in the table header. However, the value of the JSYTLEN field does not necessarily represent the minimum size required for the table, because the output symbol table created by the service can have unused space inside. The real size of meaningful data inside the output table is returned in the JSYMSRCM field. If the size of the output area provided by the caller is not sufficient for the output symbol table, the reason code field JSYMREAS will be set to JSYMSTRE and the JSYMSRCM field will contain the recommended size of the output area.

Field Name: Description
JSYMOUTA: Pointer to the caller-provided output area.
JSYMOUTS: Size of the caller-provided output area.
JSYMRETN: Service return code.
JSYMREAS: Service reason code.
JSYMSRCM: Recommended size of the output area.
JSYMERAD: If the service returns an error, this field is a pointer to the approximate location in the input data where the error was detected.
JSYMSZE1: Length of version 1 of the parameter list (JSYMPRM).
JSYMSIZE: Length of the current version of the parameter list (JSYMPRM).