EM (Element Mask)

The parameter EM controls member selection for the TOC functions. EM is a call parameter.

Extension 3 contains the PA fields (except for the passwords). The possible entries for the individual fields of the protection attributes are described under PA. Extension 3 also permits selection through the CCS names, the member status (FREE / INHOLD), the user ID of the holder, the ACCESS-DATE and ACCESS-TIME fields, and the E-SIZE-MIN and E-SIZE-MAX fields. Selection is therefore possible through specified protection attributes, but not through specified passwords. If a blank is entered or if X‘00000000‘ is entered for E-SIZE-MIN and X‘FFFFFFFF‘ for E-SIZE-MAX, any value can be used for selection.
In the case of passwords, selections can be made on the basis of the indicators (existence of a password).

Field	Meaning	Length in bytes	Contents after initialization
TYP	Member type	20	20 x X'40'
NAME	Member name	132	132 x X'40'
VERSION	Member version	52	52 x X'40'
STORE-FORM	Storage mode of member	6	6 x X'40'
USER-DATE	Date specified by user	32	32 x X'40'
USER-TIME	Time of day specified by user	20	20 x X'40'
	*********** Extension 1 ***
CREATION-DATE	Date of member generation	32	32 x X'40'
CREATION-TIME	Time of member generation	20	20 x X'40'
MODIFI-DATE	Date of last update	32	32 x X'40'
MODIFI-TIME	Time of last update	20	20 x X'40'
	*********** Extension 2 ***
SEC-NAME	Reference name	68	68 x X'40'
SEC-ATTRIBUTE	Reference attribute	20	20 x X'40'
	reserved	14	14 x X'00'
	*********** Extension 3 ***
P-TIND-READ	Protection type mask for read	1	1 x X'40'
P-READ-OWN	Read mask for owner	1	1 x X'40'
P-READ-GRP	Read mask for group	1	1 x X'40'
P-READ-OTH	Read mask for others	1	1 x X'40'
P-READ-PIND	Read password mask	1	1 x X'40'
	reserved	4	4 x X'00'
P-TIND-WRIT	Protection type mask for write	1	1 x X'40'
P-WRIT-OWN	Write mask for owner	1	1 x X'40'
P-WRIT-GRP	Write mask for group	1	1 x X'40'
P-WRIT-OTH	Write mask for others	1	1 x X'40'
P-WRIT-PIND	Write password mask	1	1 x X'40'
	reserved	4	4 x X'00'
P-TIND-EXEC	Protection type mask for exec	1	1 x X'40'
P-EXEC-OWN	Exec mask for owner	1	1 x X'40'
P-EXEC-GRP	Exec mask for group	1	1 x X'40'
P-EXEC-OTH	Exec mask for others	1	1 x X'40'
P-EXEC-PIND	Exec password mask	1	1 x X'40'
	reserved	4	4 x X'00'
P-GUARD-READ	Read guard mask	40	40 x X'40'
P-GUARD-WRIT	Write guard mask	40	40 x X'40'
P-GUARD-EXEC	Exec guard mask	40	40 x X'40'
CCS-NAME	Coded Character Set name	20	20 x X'40'
P-TIND-HOLD	Borrowing privilege mask	1	1 x X'40'
P-HOLD-OWN	Borrowing privilege mask for owner	1	1 x X'40'
P-HOLD-GRP	Borrowing privilege mask for group	1	1 x X'40'
P-HOLD-OTH	Borrowing privilege mask for others	1	1 x X'40'
P-HOLD-PIND	Borrowing password indicator mask	1	1 x X'40'
	reserved	4	4 x X'40'
P-GUARD-HOLD	Borrowing guard mask	18	18 x X'40'
HOLD-STATE	Hold flag: state assigned to the member ' ': ANY '-': FREE 'H': INHOLD	1	1 x X'40'
HOLDER	User ID of the holder	8	8 x X'40'
ACCESS-DATE	Date of last access to member	14	14 x X'40'
ACCESS-TIME	Time of last access to member	8	8 x X'40'
	reserved	3	3 x X'40'
E-SIZE-MIN	Lower limit for member size selection (PAM pages, 2-K unit)	4	X‘00000000‘
E-SIZE-MAX	Upper limit for member size selection (PAM pages, 2-K unit)	4	X‘FFFFFFFF‘
	reserved	64	64 x X‘40‘

The TOC parameter EM is required in the following functions:

TOCPRIM, TOCSEC.

Permissible wildcards for all string fields:

Wildcard	Meaning
*	Replaces any string (also a null string).
/	Replaces one arbitrary character.
<s1:s2>	Replaces a string with the following criteria: Minimum length = min(L’s1,L’s2) Maximum length = max(L’s1,L’s2) Located between "s1" and "s2" (inclusive) in alphabetical order "s1" and/or "s2" may also be empty.
<s1:s2,...>	List form of the type "s1:s2" The above rules apply for each range specified. The wildcard list replaces all strings to which one of the range entries applies (ORing). The length attributes are paired, i.e. they apply to one range entry at a time The angle brackets (’<’ and ’>’) designating a set must always be present in pairs. The characters ’*’, ’/’, ’<’, and ’>’ must not occur within sets.
-s	Replaces all strings not matching the wildcard. The minus sign may only appear at the beginning of the wildcard string.

Notes for input:

• When entering a range for USER-, CREATION- and MODIFICATION-TIME, hours must be entered as follows: <HH:HH>*

  When entering USER-, CREATION- and MODIFICATION-DATE, dates must be entered in the following form: YYYY-MM-DD*
  A date range must be entered in the following form: <YYYY-MM-DD:YYYY-MM-DD>*

  Entries should always end with the asterisk (*), as this stands for the Julian date.LMS searches for both the specified date and the Julian date which is automatically created at member generation.

  If the asterisk is omitted, LMS inserts 4 blanks instead of the Julian date. As a result, errors occur when the member mask EM is analyzed.

• A search for members to which “no code” is assigned can be conducted by entering the keyword ’*NONE’ with a trailing blank in the CCS-NAME field. If blanks are entered, members with any CCS name will be selected.

• CSECT names which exceed 32 characters are truncated to this length before the wildcard comparison, so there is no point in specifying longer wildcard strings in the SEC name field.