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 [4 (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 LMS, only the TEXT-INFORMATION and OUTPUT-FORM operands are effective.
Now LMS is able to display elements with non default CCSN and to display the text with special characters. For it the session parameters should be setting to UNICODE:
On the “Configuration” menu, select “Terminal Settings (DSS)...”; in the terminal mode (“DSS Mode”) select the option “Unicode”; in the terminal type (“DSS Type”) select the entry “DSS9763” (see UNICODE in BS2000/OSD, Introduction for details). And with MODIFY TERMINAL OPTIONS command is set UNICODE parameter : MODIFY TERMINAL OPTIONS CCS = UTFE.
SHOW-ELEMENT | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ELEMENT = *LIBRARY-ELEMENT(...)
Specifies 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; this name was defined by means of a /ADD-FILE-LINK command prior to calling LMS.
ELEMENT = *ALL / <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 with reference to BASE 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.
BASE = *STD / <composed-name 1..24 with-under with-wild>
Prefix for the version selection. In conjunction with VERSION= *HIGHEST- EXISTING , it is then possible to use a certain prefix to reference the highest existing version. BASE=*STD has the same effect as BASE=*.
TYPE = *LMS-DEFAULT / *ALL / <alphanum-name 1..8 with-wild(20)>Type of the member to be output.
USER-DATE = *ANY / *TODAY / <date8..10 with-compl> / *INTERVAL(...)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 displayed.
USER-DATE = <date 8..10 with-compl>
The member whose date is entered explicitly in the form [YY]YY-MM-DD is displayed.
USER-DATE = *INTERVAL(...)
All members lying in the specified interval are displayed.
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 USER-DATE.
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 USER-DATE.
EXCEPT-ELEMENT = *NONE / *ELEMENT(...)
Specifies the members to be excluded from the above selection.
EXCEPT-ELEMENT = *NONE
No members are excluded from correction.
EXCEPT-ELEMENT = *ELEMENT(...)
Specifies the members that are not to be displayed. A member is excluded when all the fields of the EXCEPT-ELEMENT structure that are not set to *ANY identify the member as a hit. If all the fields of the EXCEPT-ELEMENT structure are set to *ANY, then all members will be excluded.
For a description of the operands, see the *LIBRARY-ELEMENT operand of this statement.
TEXT-INFORMATION = *LMS-DEFAULT / *ALL / *STATISTICS / *FILE-ATTRIBUTES / *PARAMETERS(...)
Defines the information scope for all members except member types R, C and L.
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. For all PAM members except those of member type L, the output includes a Last Byte Pointer (LBP) if it has been stored as a file attribute. For SAM members, the output includes the net coded character set name (NETCCSN) if it has been stored as a file attribute.
TEXT-INFORMATION = *PARAMETERS(...)
Defines a member extract to be output.
INFORMATION = *LMS-DEFAULT / *ALL / list-poss(2): *TEXT / *COMMENT
The member section to be output.
INFORMATION = *ALL Everything is output.
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 = *LMS-DEFAULT / *ALL / *RANGE(...)The section of the member to be processed.
RECORD-RANGE = *ALL All records are processed.
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 = *LMS-DEFAULT / <integer 1..2147483647>
Beginning of the range, specified by the first record number. Record number 1 is the default value.
TO = *LMS-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 = *LMS-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 = *LMS-DEFAULT / <integer 1..262144>
Beginning of the record part, specified by the first character in the record. The first character is used as the default value.
LENGTH = *LMS-DEFAULT / *REST / <integer 0..262144>
Length of the record part. The remainder of the record is used as the default value.
RECORD-NUMBER = *LMS-DEFAULT / *BY-OUTPUT / *YES / *NO
Specifies output of the record numbers.
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 = *LMS-DEFAULT / *ALL / *STATISTICS / *PARAMETERS(...)
Defines the information scope for object modules (R-type members).
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 = *LMS-DEFAULT / *ALL / *TXT(...) / *TXTP(...) / list-poss(9): *ESD / *ISD / *LSD / *RLD / *REP / *INCLUDE / *DSDD / *REF / *END
The record types listed here can be selected.
INFORMATION = *TXT(...)Text records are selected.
CSECT-NAME = *LMS-DEFAULT / *ALL / <c-string 1..32 with-low> / <text 1..32>The text records can be restricted to one CSECT.
ADDRESS = *LMS-DEFAULT / <x-string 1..8>(...)
Start address of the text. The default setting is X‘00000000‘.
BASE-ADDRESS = *LMS-DEFAULT / <x-string 1..8>
The base address specified here is added to the start address. The default setting is X‘00000000‘.
LENGTH = *LMS-DEFAULT / *REST / <integer 1..2147483647> / <x-string 1..8>Length of the text.
INFORMATION = *TXTP(...)TXTP records are output.
MODIFICATION-ID = *LMS-DEFAULT / *ALL / <c-string 1..8 with-low> / *RANGE(...)
Those TXTP records with the specified identification are selected.
MODIFICATION-ID = *RANGE(...)
A group of TXTP records lying in a range can be selected.
FROM = *LMS-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 = *LMS-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 = *LMS-DEFAULT / *ALL / *STATISTICS / *PARAMETERS(...)Defines the information scope for phases (C-type members).
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 = *LMS-DEFAULT / *ALL / *ROOT / <name 1..8>Phase segment that is selected.
INFORMATION = *LMS-DEFAULT / *ALL / *TXT(...) / *TXTP(...) /list-poss(4): *ESD / *ISD / *LSD / *RLD
The record types listed here can be selected.
INFORMATION = *TXT(...)Text records are selected.
ADDRESS = *LMS-DEFAULT(...) / <x-string 1..8>(...)Start address of the text.
BASE-ADDRESS = *LMS-DEFAULT / <x-string 1..8>
The base address specified here is added to the start address.
LENGTH = *LMS-DEFAULT / *REST / <integer 1..2147483647> / <x-string 1..8>Length of the text.
INFORMATION = *TXTP(...)TXTP records are output.
MODIFICATION-ID = *LMS-DEFAULT / *ALL / <c-string 1..8 with-low> / *RANGE(...)
Those TXTP records with the specified identification are selected.
MODIFICATION-ID = *RANGE(...)
A group of TXTP records lying in a range can be selected.
FROM = *LMS-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 = *LMS-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 = *LMS-DEFAULT / *ALL / *STATISTICS / *PARAMETERS(...)Defines the information scope for link and load modules (L-type members).
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 = *LMS-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 = *LMS-DEFAULT / <structured-name 1..32>Name of the slice to be output.
LLM-PART = *SUB-LLM(...)Specifies the sub-LLM to be output.
PATH-NAME = *LMS-DEFAULT / <c-string 1..255 with-low> / <text 1..255>The sub-LLM to be output is determined by way of its path name.
INFORMATION = *LMS-DEFAULT / *ALL / *TXT(...) / *TXTP(...) / *LOGICAL(...) / *PHYSICAL / *REF / list-poss(4): *RELOCATION/ *ESVD / *ESVR / *LRLD
The record types listed here can be selected.
INFORMATION = *TXT(...)Text records are selected.
CSECT-NAME = *LMS-DEFAULT / *ALL / <c-string 1..32 with-low> / <text 1..32>The text records can be restricted to one CSECT.
ADDRESS = *LMS-DEFAULT(...) / <x-string 1..8>(...)
Start address of the text.
BASE-ADDRESS = *LMS-DEFAULT / <x-string 1..8>
The base address specified here is added to the start address.
LENGTH = *LMS-DEFAULT / *REST / <integer 1..2147483647> / <x-string 1..8>Length of the text.
INFORMATION = *TXTP(...)TXTP records are output.
CSECT-NAME = *LMS-DEFAULT / *ALL / <c-string 1..32 with-low> / <text 1..32>The TXTP records can be restricted to one CSECT.
MODIFICATION-ID = *LMS-DEFAULT / *ALL / <c-string 1..12 with-low> / *RANGE(...)
Those TXTP records with the specified identification are selected.
MODIFICATION-ID = *RANGE(...)
A group of TXTP records lying in a range can be selected.
FROM = *LMS-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 = *LMS-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 = *LMS-DEFAULT / *ALL / *NEXT
Outputs all substructures by default; otherwise, only the next substructure.
INFORMATION = *PHYSICAL
Outputs the physical structure of the LLM.
OUTPUT-FORM = *LMS-DEFAULT / *STD / *CHARACTER / *HEXADECIMAL / *DUMP Specifies the form of representation for the output.
OUTPUT-FORM = *STD
The form of representation is selected dependent on the member type. For text members this operand works in the same way as for OUTPUT-FORM = *CHARACTER.
OUTPUT-FORM = *CHARACTERThe 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.
TEXT-OUTPUT = *LOGGING-PARAMETERS / *SYSOUT / *SYSLST(...) / *EDT(...)Controls the log output.
TEXT-OUTPUT = *LOGGING-PARAMETERS
The log is output to the output medium specified with //MODIFY-LOGGING-PARAMETERS, TEXT-OUTPUT=.
TEXT-OUTPUT = *SYSOUT
The output is written to SYSOUT.
TEXT-OUTPUT = *SYSLST(...) The output is written to SYSLST.
SYSLST-NUMBER = *STD / <integer 1..99>
Determines the SYSLST file to which the output is to be written.
SYSLST-NUMBER = *STD
The system file SYSLST is used.
SYSLST-NUMBER = <integer 1..99>
The system file with the specified number from the set SYSLST01 through SYSLST99 is used.
TEXT-OUTPUT = *EDT(...)
Output is to the work file 9 of EDT. If an error occurs during log output, then the system switches to the default output stream (SYSOUT).
WRITE-MODE = *EXTEND / *REPLACE
Write mode of the output in relation to the contents of work file 9.
WRITE-MODE = *EXTEND
If data exists in work file 9, the output will be added to this data. If there is no data in the file, the output will be written at the beginning of the file.
WRITE-MODE = *REPLACE
The output will be written at the beginning of work file 9. Any data that is already in the file will be replaced.
Statement return code
(SC2) | SC1 | Maincode | Meaning |
| 0 | CMD0001 | No error |
Required access rights
For LIBRARY-ELEMENT: read authorization for LIBRARY and ELEMENT
If more than one member is affected by the statement, members without read authorization are excluded from the statement.
Examples
The member LETTER.A, which contains the text ’Dear ...’, is to be output.
//show-element (element=letter.a,type=d) INPUT LIBRARY= :1OSQ:$USER.LIB.SHOW INPUT ELEMENT= (D)LETTER.A/@(0001)/2011-04-09 DEAR ... NUMBER OF PROCESSED RECORDS IS 1
The stored file attributes for the PAM member NET.LBP.2DD with LBP are to be output.
//show-element (element=net.lbp.2dd,type=x),text-information=file attributes INPUT LIBRARY= :1OSQ:$USER.LIB.SHOW INPUT ELEMENT= (X)NET.LBP.2DD/@(0001)/2014-12-17 ORIGINAL FILE ATTRIBUTES : FILENAME= :1OSQ:$USER.LBP1.100 FILSIZE = 0000016 FCBTYPE = PAM 2ND ALLO = 00016 LBP = 00733 SHARE = NO ACCESS = WRITE BLKCTRL = NO BLKSIZE = 002048 RECFORM = U RECSIZE = 00000 PERFORM = STANDARD USAGE = NOT-SPEC