SHOW-ELEMENT displays the contents of a specified member, depending on its type. The contents of text-oriented members, modules, phases and link and load modules (LLM) can be output. The representation format of the output is controlled by the OUTPUT-FORM operand. The meaning of the attributes with modules and link and load modules is explained in the “BINDER” manual [12 (Related publications)].
The statement is permissible for all member types. User-defined types are handled according to their respective base type. If the base type is unknown to LMSCONV, only the TEXT-INFORMATION and OUTPUT-FORM operands are effective. The scope of information can be restricted for textual members.
Format
SHOW-ELEMENT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
ELEMENT = *LIBRARY-ELEMENT(...)
Specifications for the desired member designation.
LIBRARY = *STD / <filename 1..54 without-vers> / *LINK(...)
Specifies the library containing the member.
LIBRARY = *STD
The library opened by OPEN-LIBRARY.
LIBRARY = <filename 1..54 without-vers>
Name of the library containing the member.
LIBRARY = *LINK(...)
The library assigned via the link name.
LINK-NAME = <structured-name 1..8>
Link name of the library.
ELEMENT = *ALL(...) / <composed-name 1..64 with-under with-wild(132)>(...)
ELEMENT = *ALL(...)
Information is output on all members.
ELEMENT = <composed-name 1..64 with-under with-wild(132)>(...)
Name of the member to be displayed.
VERSION = *HIGHEST-EXISTING / *ALL / *UPPER-LIMIT
<composed-name 1..24 with-under with-wild(52)>
Version of the member to be output.
VERSION = *HIGHEST-EXISTING
The member with the highest existing version is output.
VERSION = *UPPER-LIMIT
The highest possible version X'FF' in the library under the specified TYPE and name is displayed.
VERSION = <composed-name 1..24 with-under with-wild(52)>
Explicitly specifies the version of the member to be displayed.
TYPE = *DEFAULT / *ALL / <alphanum-name 1..8 with-wild(20)>
Type of the member to be output. If the value is *DEFAULT and the current value set with MODIFY-DEFAULTS is *NONE, LMSCONV requires a type specification.
USER-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVALL(...)
Date given by the user.
USER-DATE = *ANY
The member to be output has any date.
USER-DATE = *TODAY
The member with the current date is output.
USER-DATE = <date 8..10 with-compl>
The member whose date is entered explicitly in the form [YY]YY-MM-DD is output.
USER-DATE = *INTERVAL(...)
All members lying in the specified interval are output.
FROM = 1900-01-01 / <date 8..10 with-compl>
Beginning of interval.
TO = *TODAY / <date 8..10 with-compl>
End of interval.
CREATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
Creation date of the member. For a description of the operands, see the USER-DATE operand of this statement.
MODIFICATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
Date of the last modification to the member. For a description of the operands, see the USER-DATE operand of this statement.
TEXT-INFORMATION = *DEFAULT / *ALL / *STATISTICS / *FILE-ATTRIBUTES / *PARAMETER(...)
Defines the information scope for all members except member types R, C and L. The default setting is *ALL (see below) or the current value set with MODIFY-DEFAULTS.
TEXT-INFORMATION = *ALL
Everything is output.
TEXT-INFORMATION = *STATISTICS
The number of records per record type and the total number of records are output. For each record type, the total of all record lengths (without record length fields) is output, as is the total record length across all record types.
TEXT-INFORMATION = *FILE-ATTRIBUTES
Only the stored file attributes are output.
TEXT-INFORMATION = *PARAMETERS(...)
Defines a member extract to be output.
INFORMATION = *DEFAULT / *ALL / list-poss(2): *TEXT / *COMMENT
The member section to be output. The default setting is *ALL (see below) or the current value set with MODIFY-DEFAULTS.
INFORMATION = *ALL
Outputs all user record types.
INFORMATION = *TEXT
Outputs the text itself, i.e. record type 1.
INFORMATION = *COMMENT
Outputs the separately stored comment, i.e. record type 2.
RECORD-RANGE = *DEFAULT / *ALL / *RANGE(...)
The section of the member to be processed. The default setting is *ALL (see below) or the current value set with MODIFY-DEFAULTS.
RECORD-RANGE = *ALL
Processes all user record types.
RECORD-RANGE = *RANGE(...)
Specifies the range of record numbers which is to be processed. The record numbers refer not to a record type, but to the section of the member designated by means of INFORMATION=. Within this section, the records are numbered consecutively from 1 through n.
FROM = *DEFAULT / <integer 1..2147483647>
Beginning of the range, specified by the first record number. Record number 1 is the default value.
TO = *DEFAULT / *LAST / <integer 1..2147483647>
End of the range, specified by the last record number. The last record number is used as the default value.
RECORD-PART = *DEFAULT / *ALL / *PART(...)
Specifies the part of the record to be processed.
RECORD-PART = *ALL
Processes the entire record.
RECORD-PART = *PART(...)
Specifies the part of the record to be processed. If the default values are not changed, the entire record is processed.
START = *DEFAULT / <integer 1..32764>
Beginning of the record part, specified by the first character in the record. The first character is used as the default value.
LENGTH = *DEFAULT / *REST / <integer 1..32764>
Length of the record part. The remainder of the record is used as the default value.
RECORD-NUMBER = *DEFAULT / *BY-OUTPUT / *YES / *NO
Specifies output of the record numbers. The default value is *BY-OUTPUT (see below) or the current value set with MODIFY-DEFAULTS.
RECORD-NUMBER = *BY-OUTPUT
Only if the output is directed to SYSOUT will no record numbers be output. With any other output medium, the record numbers are included in the output.
RECORD-NUMBER = *YES
The record numbers are also output to SYSOUT.
RECORD-NUMBER = *NO
No record numbers are included in the output..
MODULE-INFORMATION = *DEFAULT / *ALL / *STATISTICS / *PARAMETERS(...)
Defines the information scope for object modules (R-type members). The default setting is *ALL (see below) or the current value set with MODIFY-DEFAULTS.
MODULE-INFORMATION = *ALL
Everything is output.
MODULE-INFORMATION = *STATISTICS
The name, length and address of the CSECTS and also the overall length of the module are output.
MODULE-INFORMATION = *PARAMETERS(...)
This parameter determines whether all record types or only selected record types are output.
INFORMATION = *DEFAULT / *ALL / *TXT(...) / *TXTP(...) / list-poss(9): *ESD / *ISD / *LSD / *RLD / *REP / *INCLUDE / *DSDD / *REF / *END
The record types listed here can be selected. The default setting is *ALL or the current value set with MODIFY-DEFAULTS.
INFORMATION = *TXT(...)
Text records are selected.
CSECT-NAME = *DEFAULT / *ALL / <c-string 1..32 with-low> / <text 1..32>
The text records can be restricted to one CSECT. The default setting is *ALL or the current value set with MODIFY-DEFAULTS.
ADDRESS = *DEFAULT / <x-string 1..8>(...)
Start address of the text. The default setting is X'00000000' or the current value set with MODIFY-DEFAULTS.
BASE-ADDRESS = *DEFAULT / <x-string 1..8>
The base address specified here is added to the start address. The default setting is X'00000000' or the current value set with MODIFY-DEFAULTS.
LENGTH = *DEFAULT / *REST / <integer 1..2147483647> / <x-string 1..8>
Length of the text. The default setting is *REST or the current value set with MODIFY-DEFAULTS.
INFORMATION = *TXTP(...)
TXTP records are output.
MODIFICATION-ID = *DEFAULT / *ALL / <c-string 1..8 with-low> / *RANGE(...)
Those TXTP records with the specified identification are selected. The default setting is *ALL or the current value set with MODIFY-DEFAULTS.
MODIFICATION-ID = *RANGE(...)
A group of TXTP records lying in a range can be selected.
FROM = *DEFAULT / *LOWEST / <c-string 1..8 with-low>
The beginning of the range is by default the lowest identification for the TXTP records, otherwise the value entered here.
TO = *DEFAULT / *HIGHEST / <c-string 1..8 with-low>
The end of the range is by default the highest identification for the TXTP records, otherwise the value entered here.
PHASE-INFORMATION = *DEFAULT / *ALL / *STATISTICS / *PARAMETER(...)
Defines the information scope for phases (C-type members). The default setting is *ALL or the current value set with MODIFY-DEFAULTS.
PHASE-INFORMATION = *ALL
Everything is output.
PHASE-INFORMATION = *STATISTICS
The name, length and address of the segment and also the overall length of the segment are output.
PHASE-INFORMATION = *PARAMETERS(...)
This parameter determines whether all record types or only selected record types are output.
SEGMENT = *DEFAULT / *ALL / *ROOT / <name 1..8>
Phase segment that is selected. The default setting is *ALL or the current value set with MODIFY-DEFAULTS.
INFORMATION = *DEFAULT / *ALL / *TXT(...) / *TXTP(...) / list-poss(4): *ESD / *ISD / *LSD / *RLD
The record types listed here can be selected. The default setting is *ALL or the current value set with MODIFY-DEFAULTS.
INFORMATION = *TXT(...)
Text records are selected.
ADDRESS = *DEFAULT / <x-string 1..8>(...)
Start address of the text. The default setting is X'00000000' or the current value set with MODIFY-DEFAULTS.
BASE-ADDRESS = *DEFAULT / <x-string 1..8>
The base address specified here is added to the start address. The default setting is X'00000000' or the current value set with MODIFY-DEFAULTS.
LENGTH = *DEFAULT / *REST / <integer 1..2147483647> / <x-string 1..8>Length of the text. The default setting is *REST or the current value set with MODIFY-DEFAULTS.
INFORMATION = *TXTP(...)
TXTP records are output.
MODIFICATION-ID = *DEFAULT / *ALL / <c-string 1..8 with-low> / *RANGE(...)Those TXTP records with the specified identification are selected. The default setting is *ALL or the current value set with MODIFY-DEFAULTS.
MODIFICATION-ID = *RANGE(...)
A group of TXTP records lying in a range can be selected.
FROM = *DEFAULT / *LOWEST / <c-string 1..8 with-low>
The beginning of the range is by default the lowest identification for the TXTP records, otherwise the value entered here.
TO = *DEFAULT / *HIGHEST / <c-string 1..8 with-low>
The end of the range is by default the highest identification for the TXTP records, otherwise the value entered here.
LLM-INFORMATION = *DEFAULT / *ALL / *STATISTICS / *PARAMETERS(...)
Defines the information scope for link and load modules (L-type members). The default setting is *ALL (see below) or the current value set with MODIFY-DEFAULTS.
LLM-INFORMATION = *ALL
Everything is output.
LLM-INFORMATION = *STATISTICS
General information on the link and load module (name, copyright, ...) is output.
LLM-INFORMATION = *PARAMETERS(...)
This parameter determines whether all record types or only selected record types are output.
LLM-PART = *DEFAULT / *ALL / *SLICE(...) / *SUB-LLM(...)
Specifies the LLM part to be selected. By default the entire LLM is selected.
LLM-PART = *SLICE(...)
Specifies the slice to be output.
NAME = <structured-name 1..32>
Name of the slice to be output.
LLM-PART = *SUB-LLM(...)
Specifies the sub-LLM to be output.
PATH-NAME = *DEFAULT / <c-string 1..255 with-low> / <text 1..255>
The sub-LLM to be output is determined by way of its path name. The default setting is *ALL or the current value set with MODIFY-DEFAULTS.
INFORMATION = *DEFAULT / *ALL / *TXT(...) / *TXTP(...) / *LOGICAL(...) / *PHYSICAL / *REF / list-poss(4): *ESVD / *ESVR / *LRLD / *RELOCATION
The record types listed here can be selected. The default setting is *ALL or the current value set with MODIFY-DEFAULTS.
INFORMATION = *TXT(...)
Text records are selected.
CSECT-NAME = *DEFAULT / *ALL / <c-string 1..32 with-low> / <text 1..32>The text records can be restricted to one CSECT.
ADDRESS = *DEFAULT / <x-string 1..8>(...)
Start address of the text. The default setting is X'00000000' or the current value set with MODIFY-DEFAULTS.
BASE-ADDRESS = *DEFAULT / <x-string 1..8>
The base address specified here is added to the start address. The default setting is X'00000000' or the current value set with MODIFY-DEFAULTS.
LENGTH = *DEFAULT / *REST / <integer 1..2147483647> / <x-string 1..8>
Length of the text. The default setting is *REST or the current value set with MODIFY-DEFAULTS.
INFORMATION = *TXTP(...)
TXTP records are output.
CSECT-NAME = *DEFAULT / *ALL / <c-string 1..32 with-low> / <text 1..32>
The TXTP records can be restricted to one CSECT. The default setting is *ALL or the current value set with MODIFY-DEFAULTS.
MODIFICATION-ID = *DEFAULT / *ALL / <c-string 1..12 with-low> / *RANGE(...)
Those TXTP records with the specified identification are selected. The default setting is *ALL or the current value set with MODIFY-DEFAULTS.
MODIFICATION-ID = *RANGE(...)
A group of TXTP records lying in a range can be selected.
FROM = *DEFAULT / *LOWEST / <c-string 1..12 with-low>
The beginning of the range is by default the lowest identification for the TXTP records, otherwise the value entered here.
TO = *DEFAULT / *HIGHEST / <c-string 1..12 with-low>
The end of the range is by default the highest identification for the TXTP records, otherwise the value entered here.
INFORMATION = *LOGICAL(...)
Outputs the logical structure of the LLM.
LEVEL = *DEFAULT / *ALL / *NEXT
Outputs all substructures by default; otherwise, only the next substructure.
INFORMATION = *PHYSICAL
Outputs the physical structure of the LLM.
OUTPUT-FORM = *DEFAULT / *STD / *CHARACTER / *HEXADECIMAL / *DUMP
Specifies the form of representation for the output. The default setting is *STD or the current value set with MODIFY-DEFAULTS.
OUTPUT-FORM = *STD
The form of representation is selected dependent on the member type.
OUTPUT-FORM = *CHARACTER
The output is in alphanumeric form.
OUTPUT-FORM = *HEXADECIMAL
The output is in alphanumeric and hexadecimal form, one above the other.
OUTPUT-FORM = *DUMP
The output is in alphanumeric and hexadecimal form, side by side. For member types S, P, D, J and M, this operand has the same effect as OUTPUT-FORM=*HEXADECIMAL.
Examples
The member LETTER.A, which contains the text “Dear ...”, is to be output.
//show-element (element=letter.a,type=d) INPUT LIBRARY= :N:$USER.TEST.LIB INPUT ELEMENT= (D)LETTER.A/ (0001)/<date> Dear ... ... ... Yours sincerely, ... NUMBER OF PROCESSED RECORDS IS 123
The stored file attributes of a member with LBP are to be output.
//show-element (element=net.lbp.2dd,type=x),text-information=file-attributes INPUT LIBRARY= :SQGB:$TSOS.BIB.ALI INPUT ELEMENT= (X)PTF04/§(0001)/<date> ORIGINAL FILE ATTRIBUTES : FILENAME= :CK33:$TSOS.PTF04 FILSIZE = 0000009 FCBTYPE = PAM 2ND ALLO= 00006 LBP = 13312 SHARE = NO ACCESS = WRITE BLKCTRL = DATA BLKSIZE = 014336 RECFORM = U RECSIZE = 00000 PERFORM = STANDARD USAGE = NOT-SPEC
The stored file attributes of a member with NETCCSN are to be output.
//show-element (element=stf03,type=x),text-information=file-attributes INPUT LIBRARY= :SQGB:$TSOS.BIB.ALI INPUT ELEMENT= (X)STF03/@(0001)/<date> ORIGINAL FILE ATTRIBUTES : FILENAME= :CK33:$DMS01.STF03 FILSIZE = 0000032 FCBTYPE = SAM 2ND ALLO= 00016 SHARE = NO ACCESS = WRITE BLKCTRL = DATA BLKSIZE = 032768 RECFORM = V RECSIZE = 00000 PERFORM = STANDARD USAGE = NOT-SPEC NETCCSN = ISO88591