SHOW-ELEMENT-ATTRIBUTES outputs the directory entries of the specified members or of the entire library.
The entries are output on the medium specified by the MODIFY-LOGGING-PARAMETERS statement. With the STRUCTURE-OUTPUT operand, the output can also be placed in a structured S variable (list).
The directory is always output sorted by type. The remainder of the sort sequence is determined by the SORT operand. The default sort sequence is type, name and version.
The INFORMATION and LAYOUT operands are used to specify the scope and format of the directory output. By default, the type, name, version, variant number and date are output.
With the aid of the SECONDARY-NAME and SECONDARY-ATTRIBUTE operands, the directory can be limited to the members containing a certain reference entry.
Note
In order to obtain the entire contents of a library (all members with all versions), it is sufficient to specify only SHOW-ELEMENT-ATTRIBUTES without any operands, provided no specific member type or version was set using MODIFY-LMS-DEFAULTS.
SHOW-ELEMENT-ATTRIBUTES | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ELEMENT = *LIBRARY-ELEMENT(...)
Specifications for the desired member designation(s).
LIBRARY = *STD / <filename 1..54 without-vers> / *LINK(...)
Specifies the library for which the directory is to be output.
LIBRARY = *STD
The library opened by OPEN-LIBRARY.
LIBRARY = <filename 1..54 without-vers>
Outputs the directory of the library specified here.
LIBRARY = *LINK(...)
The library assigned via the link name.
LINK-NAME = <structured-name 1..8>
Link name of the library, which was defined by means of a /ADD-FILE-LINK command.
ELEMENT = *ALL / <composed-name 1..64 with-under with-wild(132)>(...) Name of the member for which the library entry is to be output.
If the default value “*ALL” is entered, LMS outputs the library entries for all of the members with the corresponding version and type.
VERSION = *ALL / *HIGHEST-EXISTING / *UPPER-LIMIT /
<composed-name 1..24 with-under with-wild(52)>
Version of the member.
VERSION = *ALL
Outputs the library entries of all members selected above, regardless of their respective versions.
VERSION = *HIGHEST-EXISTING
The library entries of all members selected above are output with the highest existing version.
VERSION = *UPPER-LIMIT
The library entries of all members selected above are output with the version X’FF’.
VERSION = <composed-name 1..24 with-under with-wild(52)>
The library entries of all members selected above are output with the version specified here.
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=*.
The operand will be ignored, if anything other than *ANY is specified in the SECONDARY-NAME or the SECONDARY-ATTRIBUTE operands.
TYPE = *LMS-DEFAULTS / *ALL / <alphanum-name 1..8 with-wild(20)
Type of the member which is to be output.
If the LMS default value for TYPE is *UNDEFINED, then *LMS-DEFAULT has the same effect as *ALL
USER-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)Date given by the user.
USER-DATE = *ANY
The member has any date.
USER-DATE = *TODAY
The library entries of all members with the current date are output.
USER-DATE = <date 8..10 with-compl>
The library entries of all members with the date specified here in the form [YY]YY-MM-DD are output.
USER-DATE = *INTERVAL(...)
The library entries of 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 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.
ACCESS-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
Date on which the member was last accessed. For a description of the operands, see USER-DATE.
USER-TIME = *ANY / <time 1..8> / *INTERVAL(...)
Time given by the user.
USER-TIME = *ANY
The library entries of all members are output, regardless of the time.
USER-TIME = <time 1..8>
The library entries of all members with the time specified in the form HH:MM:SS are output.
USER-TIME = *INTERVAL(...)
The library entries of all members lying in the specified interval are output.
FROM = 00:00:00 / <time 1..8>
Beginning of interval.
TO = 23:59:59 / <time 1..8>
End of interval.
CREATION-TIME = *ANY / <time1..8> / *INTERVAL(...)
Creation time of the member. For a description of the operands, see USER-TIME.
MODIFICATION-TIME = *ANY / <time 1..8> / *INTERVAL(...)
Time of the last modification to the member. For a description of the operands, see USER-TIME.
ACCESS-TIME = *ANY / <time 1..8> / *INTERVAL(...)
Time at which the member was last accessed. For a description of the operands, see USER-TIME.
CODED-CHARACTER-SET = *ANY / *NONE / <name 1..8 with-wild(20)>Character set assigned to the member.
CODED-CHARACTER-SET = *ANY
Selects members without regard to their assigned character set.
CODED-CHARACTER-SET = *NONE
Selects members which have not been assigned a character set.
CODED-CHARACTER-SET = <name 1..8 with-wild(20)>
Selects the members to which the specified character set has been assigned.
STATE = *ANY / *FREE / *IN-HOLD(...)
State assigned to the member.
STATE = *ANY
Selects members without regard to their respective STATEs.
STATE = *FREE
Selects only members with STATE=FREE
STATE = *IN-HOLD(...)
Selects only members with STATE=IN-HOLD.
HOLDER = *ANY / <name 1..8 with-wild(20)>
HOLDER assigned to the member.
HOLDER = *ANY
Selects members without regard to their respective HOLDERs.
HOLDER = <name 1..8 with-wild(20)>
Selects only members which are assigned a HOLDER matching the pattern.
STORAGE-FORM = *ANY / *FULL / *DELTA
Storage form for the member to be displayed.
STORAGE-FORM = *ANY
LMS selects the member on the basis of the storage form. The member may be stored as a non-delta or delta member.
STORAGE-FORM = *FULL
The member must be stored as a non-delta member.
STORAGE-FORM = *DELTA
The member must be stored as a delta member.
SECONDARY-NAME = *ANY / <alphanum-name 1..32 with-wild(68)>
Secondary name. If anything other than *ANY is specified here, the selection is made via the secondary directory of the library.
If wildcards are specified, only the first 32 characters of the secondary name are used to determine the selection.
SECONDARY-ATTRIBUTE = *ANY / *CSECT / *ENTRY
Secondary attribute. If anything other than *ANY is specified here, the selection is made via the secondary directory of the library.
ELEMENT-SIZE = *ANY / <integer 0..2147483647> / *INTERVAL(...)
Specifies the size according to which the members are to be selected.
ELEMENT-SIZE = *ANY
The member size is not used as a selection criterion.
ELEMENT-SIZE = <integer 0..2147483647>
Members are selected whose memory allocation corresponds to the specified number of PAM pages (2-K unit).
ELEMENT-SIZE = *INTERVAL(..)
Members are selected whose memory allocation lies within the specified range.
FROM = 0 / <integer 1..2147483647>
Members are selected whose memory allocation corresponds to at least the specified number of PAM pages (2-K unit).
TO = 2147483647 / <integer 1..2147483647>
Members are selected whose memory allocation corresponds to no more than the specified number of PAM pages (2-K unit).
PROTECTION = *ANY / *NONE / *PARAMETERS(...)
Member protection for the selected members.
PROTECTION = *ANY
The members are selected, regardless of the member protection.
PROTECTION = *NONE
The members have no additional member protection.
PROTECTION = *PARAMETERS(...)
Specifies the protection with which the members to be selected are provided.
READ = *ANY / *NONE / *BY-GUARD(...) / *PARAMETERS(...)
Read protection setting assigned to the member.
READ = *ANY
Selects members without regard to their read protection settings.
READ = *NONE
Selects only members with no read protection.
READ = *BY-GUARD(...)
Selects only members which have GUARD read protection.
GUARD-NAME = <filename 1..40 without-cat-gen-vers with-wild>
Selects only members which have read protection by a GUARD-NAME
matching the pattern.
READ = *PARAMETERS(...)
Selects only members which have read protection by BACL and/or password.
USER = *ANY / *NONE / *ALL / list-poss(3): *OWNER / *GROUP / *OTHERS The read-authorized user group which is assigned to the member.
USER = *ANY
Selects members without regard to their respective read-authorized user groups.
USER = *NONE
Selects only members for which no read authorization has been granted.
USER = *OWNER
Selects only members for which the owner of the library file has read
authorization.
USER = *GROUP
Selects only members for which the library file owner’s group has read
authorization.
USER = *OTHERS
Selects only members for which read authorization for OTHERS has been granted.
PASSWORD = *ANY / *YES / *NO
Read password assigned to the member.
PASSWORD = *ANY
Selects members without regard to their respective passwords.
PASSWORD = YES
Selects only members which are protected by a read password.
PASSWORD = *NO
Selects only members which are not protected by a read password.
WRITE = *ANY / *NONE / *BY-GUARD(...) / *PARAMETERS(...)
Write authorization. Selects only members for which this authorization has been granted in the specified manner.
The operands are analogous to those described above for READ.
EXEC = *ANY / *NONE / *BY-GUARD(...) / *PARAMETERS(...)
Execute authorization. Selects only members for which this authorization has been granted in the specified manner.
The operands are analogous to those described above for READ.
HOLD = *ANY / *NONE / *BY-GUARD(...) / *PARAMETERS(...)
Hold authorization. Selects only members for which this authorization has been granted in the specified manner.
The operands are analogous to those described above for READ.
EXCEPT-ELEMENT = *NONE / *ELEMENT(...)
Specifies the members to be excluded from the above selection.
EXCEPT-ELEMENT = *NONE
No members are excluded.
EXCEPT-ELEMENT = *ELEMENT(...)
Specifies the members to be excluded from selection. 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 *LIBRARY-ELEMENT.
INFORMATION = *LMS-DEFAULT / *MEDIUM / *MINIMUM / *MAXIMUM / *SUMMARY / *DELTA-STRUCTURE / *PARAMETERS(...)
This parameter defines the scope of directory information to be output. It also specifies the scope of the structure output (see parameter dependencies.
INFORMATION = *MEDIUM
Outputs the type, name, version, variant number and, depending on the SORT operand, the date or size of the selected member.
INFORMATION = *MINIMUM
Outputs only the type, name and version of the selected member.
INFORMATION = *MAXIMUM
All the information of the selected member is output.
INFORMATION = *SUMMARY
Outputs only the number of selected members per type.
INFORMATION = *DELTA-STRUCTURE
Only the relationship “predecessor - successor” is output for delta members. As well as the member designation the internal delta number (DELTA#, reflects the chronological order) and the associated base number (BASE#) are output. These internal delta numbers are unique within a tree, they define the chaining of the members in the tree (independent of the external user-specific version designation). The output of a tree is always sorted by DELTA#, i.e. the SORT operand is not effective within a tree. Different trees are separated from each other by means of a continuous line.
The output fields DELTA# and BASE# for non-delta members are empty.
INFORMATION = *PARAMETERS(...)
Additional outputs
GENERAL = *LMS-DEFAULT / *NO / *YES
Defines whether, in addition to the type, name, version and variant number, a general information block is to be output comprising the storage format, status, member size and, if applicable, the character set and HOLDER of the selected member.
HISTORY = *LMS-DEFAULT / *NO / *YES
Defines whether, in addition to the type, name, version and variant number, a HISTORY block is to be output comprising the user date/time, creation date/time, modification date/time and, if applicable, the access date/time of the selected member.
SECURITY = *LMS-DEFAULT / *NO / *YES
Defines whether, in addition to the type, name, version and variant number, a SECURITY block for the selected member is to be output, if additional member protection has been granted for an access or borrowing right.
LAYOUT = *LMS-DEFAULT / *VARIABLE / *FIXED
This parameter defines the format of the directory to be output.
LAYOUT = *VARIABLE
The number of print columns is determined by the longest member designation within a member type. With output to the screen and no special sorting, the layout is oriented to the longest member designation in the output buffer, where subsequent outputs within a member type only change if longer member designations occur.
LAYOUT = *FIXED
The directory is printed in a single column in fixed format. Single column means that the entries in the directory appear one beneath the other.
SORT = *LMS-DEFAULT / *BY-NAME / *BY-VERSION / *BY-USER-DATE / *BY-CREATION-DATE / *BY-MODIFICATION-DATE / *BY-ACCESS-DATE /*BY-ELEMENT-SIZE / *BY-SECONDARY-NAME
Sort criterion for the directory entries of the selected members. The type is always used as the first sort criterion.
SORT = *BY-NAME
The directory entries of the selected members are sorted on the basis of the following sequence: type, name and version.
SORT = *BY-VERSION
The directory entries of the selected members are sorted on the basis of the following sequence: type, version and name.
SORT = *BY-USER-DATE
The directory entries of the selected members are sorted on the basis of the following sequence: type, user date, name and version.
SORT = *BY-CREATION-DATE
The directory entries of the selected members are sorted on the basis of the following sequence: type, creation date, name and version.
SORT = *BY-MODIFICATION-DATE
The directory entries of the selected members are sorted on the basis of the following sequence: type, modification date, name and version.
SORT = *BY-ACCESS-DATE
The directory entries of the selected members are sorted on the basis of the following sequence: type, access date, name and version.
SORT = *BY-ELEMENT-SIZE
The directory entries of the selected members are sorted on the basis of the following sequence: type, member size, name and version.
SORT = *BY-SECONDARY-NAME
The directory entries of the selected members are sorted on the basis of the following sequence: type, secondary name, secondary attribute, name and version.
TEXT-OUTPUT = *LOGGING-PARAMETERS / *NONE / *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 = *NONE
The log output is suppressed, apart from error messages.
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.
STRUCTURE-OUTPUT = *SYSINF / *NONE / <composed-name 1..255>(...) Structured output.
STRUCTURE-OUTPUT = *SYSINF
The structured output is placed in the SYSINF stream assigned by means of ASSIGN-STREAM (see the [12]).
STRUCTURE-OUTPUT = *NONE
There is no structured output.
STRUCTURE-OUTPUT = <composed-name 1..255>(...)
Specifies the S variable in which the structured output is to be placed. This variable must be declared as a dynamic list variable.
(Command: DECLARE-VARIABLE NAME=...(TYPE=*STRUCTURE),MULTIPLE-ELEMENTS=*LIST)
WRITE-MODE = *REPLACE / *EXTEND
Specifies whether the structured output is to be appended to any existing data in the list variable or it to be written over it.
WRITE-MODE = *REPLACE
Overwrites any existing data in the list variable.
WRITE-MODE = *EXTEND
Appends the new list members to the existing list, if any.
Statement return code
(SC2) | SC1 | Maincode | Meaning |
| 0 | CMD0001 | No error |
Notes
If the SECONDARY-NAME or SECONDARY-ATTRIBUTE operand is specified and if the value of this operand is other than *ANY, then a header will also be included in the directory output, providing information on the secondary name and the secondary attribute. The secondary names, however, are not displayed at maximum length.
In the case of delta members, the value output for ELEM-SIZE or the selection of the member size is based on the memory allocation for the whole delta tree. Other measurements of the size of individual member versions can be displayed by means of SHOW-ELEMENT ...,TEXT-INFO=*STATISTICS.
If a library list is specified, INFORMATION=*DELTA-STRUCTURE is not permitted. For SECONDARY-NAME and SECONDARY-ATTRIBUTES, only the value *ANY is allowed.
Required access rights
Read authorization for LIBRARY.
Parameter dependencies
The following dependencies exist between the INFORMATION, SORT and LAYOUT operands:
The current date or the member size only influences the sorting if it, too, is to be included in the directory output. In this case, the INFORMATION operand must have a setting other than *MINIMUM.
The LAYOUT operand is only effective if INFORMATION = *MEDIUM/*MINIMUM is specified. With all other settings, the directory is always output in fixed format.
If INFORMATION = *MAXIMUM is specified, the information for each member will be too long for a single line. The information will then be output in a format independent of layout control.
Output of the directory is accelerated if the INFORMATION operand is set to *MINIMUM and the selection is restricted to the ELEMENT, VERSION and TYPE operands. All other operands should be set to the value *ANY.
The SORT and INFORMATION operands (except for INFORMATION=*SUMMARY) influence the sort sequence of the directory. The following table shows these dependencies:
SORT
INFORMATION
*MINIMUM
*MEDIUM / *MAXIMUM /
*PAR*BY-NAME
1. Type
2. Name
3. Version1. Type
2. Name
3. Version*BY-VERSION
1. Type
2. Version
3. Name1. Type
2. Version
3. Name*BY-USER-DATE
as
SORT1. Type
2. User date
3. Name
4. Version*BY-CREATION-DATE
as
SORT1. Type
2. Creation date
3. Name
4. Version*BY-MODIFICATION-DATE
as
SORT1. Type
2. Modification date
3. Name
4. Version*BY-ACCESS-DATE
as
SORT1. Type
2. Access date
3. Name
4. Version*BY-ELEMENT-SIZE
as
SORT1. Type
2. Member size
3. Name
4. Version*BY-SECONDARY-NAME
- with reference1)
1. Type
2. Secondary name
3. Secondary attribute
4. Name
5. Version1. Type
2. Secondary name
3. Secondary attribute
4. Name
5. Version- without reference2)
1. Type
2. Name
3. Version1. Type
2. Name
3. Version1with reference means that in member selection either the secondary name or the secondary attribute was specified with a value other than the default ANY:
SECONDARY-NAME = <alphanum-name...>
and/or SECONDARY-ATTRIBUTE = *CSECT or *ENTRY2without reference means that in member selection neither a secondary name nor a secondary attribute was specified.
When generating structured output (STRUCTURE-OUTPUT =<composed-name 1..255>), bear in mind the SORT and INFORMATION operands. The following dependencies exist:
The sort order is identical to that used for text output, and the INFORMATION operand has the same effect on the sort order as it does in text output.
One list member is generated for each directory entry to be output.
The INFORMATION operand influences the scope of information output in the S variable.
The individual variable members are described in chapter "Format of LMS output in S variables".
If INFORMATION = *DELTA-STRUCTURE, LMS outputs information in the S variable like for INFORMATION = *MEDIUM (see chapter "Format of LMS output in S variables"). In addition, the internal delta number and the corresponding number of the base are provided in the variables varname#.DLT and varname#.BASE, respectively.
Example
Outputting the directory for the library USER.BSPLIB. The library contains precisely one member which is displayed with all its attributes.
//SHOW-ELEMENT-ATTRIBUTES - (LIBRARY=USER.BSPLIB,ELEMENT=*(VERSION=*)),INFORMATION=*MAXIMUM INPUT LIBRARY= :N:$USER.USER.BSPLIB TYPE = D NAME = TEST VERSION = @ VARIANT = 0001 --------------------------------GENERAL----------------------------------- ELEM-SIZE = 12 STORAGE = *FULL STATE = *FREE --------------------------------- HISTORY --------------------------------- USER-DATE = 2021-03-24 CRE-DATE = 2021-03-24 MOD-DATE = 2021-03-24 USER-TIME = 11:00:00 CRE-TIME = 10:56:15 MOD-TIME = 11:00:00 --------------------------------- SECURITY -------------------------------- READ-PASS = *NONE READ-USER = *OWNER *GROUP *OTHERS WR-PASS = *NONE WR-USER = *OWNER *GROUP - EXEC-PASS = *NONE EXEC-USER = *OWNER *GROUP *OTHERS DESTROY = *YES