Parameters

data-id

The data ID associated with the data set to be searched. The data ID is generated by the LMINIT service. The maximum length of this parameter is 8 characters.

member-name

The name of the member to be found. The maximum length of this parameter is 8 characters.

LOCK

The LOCK parameter is no longer used since the removal of LMF from the ISPF product, but is left in for compatibility. If LOCK is specified, the LMMFIND service will fail with return code 12. Start of change

If you want to be able to specify LOCK and have LMMFIND ignore the value, change the value of the FAIL_ON_LMF_LOCK keyword in the ISPF Configuration Table to NO. End of change

lrecl-var

The name of the variable into which the data record length (or, if the record format is of variable length, the maximum data record length) is to be stored. The maximum length of this parameter is 8 characters.

recfm-var

The name of the variable into which the record format code is to be stored. An example is FB for fixed-length block data. The maximum length of this parameter is 8 characters.

group-var

The name of the variable that will store the name of the group that contains the found member. This variable contains the group name after the service is executed only if the data is an ISPF library or a set of concatenated ISPF libraries and LMINIT is used with ISPF name parameters; otherwise, the variable is set to null. The maximum length of this parameter is 8 characters.

YES|NO (STATS)

Whether statistics for the member are to be returned to the dialog invoking the service. If you specify NO, no statistics are returned. If you specify YES and the data ID represents a data set that has unformatted records (RECFM=U), the statistics are returned in these dialog variables:

ZLAC

A 2-character field containing the authorization code of the member.

ZLALIAS

An 8-character field containing the name of the real member that this member is an alias of. If the member is not an alias this field is blank.

ZLAMODE

A 3-character field containing the AMODE of the member.

ZLATTR

A 20-character field containing the load module attributes. The attributes are 2-character strings separated by blanks. These strings can appear in the attribute string:

NX: Not executable
OL: Only Loadable
OV: Overlay
RF: Refreshable
RN: Reentrant
RU: Reusable
SC: Scatter Load
TS: Test

ZLLIB

Position in concatenated data set sequence; a number from 1 to 16.

ZLRMODE

A 3-character field containing the RMODE of the member.

ZLSIZE

An 8-character field containing the load module size in hex.

ZLTTR

A 6-character field containing the TTR of the member.

ZLSSI

An 8-character field containing the SSI information for a load module.

For other record formats (F or V), the statistics are returned in these dialog variables:

ZLC4DATE: Creation date, a character variable shown in your national format with a 4-character year. Use system variable ZDATEF to determine the national format. If no value exists for this variable, ISPF sets the value to blanks.
ZLCDATE: Creation date, a character value shown in your national format. Use system variable ZDATEF to determine the national format. If no value exists for this variable, ISPF sets the value to blanks.
ZLCNORC: Current number of records; a number in the range 0 - 65535. If no value exists for this variable, ISPF sets the value to blanks.
ZLCNORCE: 10-character field. If ZLEXT=YES, contains the current number of records; a number in the range 0 - 2147483647.
ZLEXT: Indicates whether extended PDS statistics are available. The length is 3, and possible values are blanks or YES. If ZLEXT has a value of YES, variables ZLCNORCE, ZLINORCE, and ZLMNORCE contain values.
ZLINORC: Initial number of records; a number in the range 0 - 65535.
ZLINORCE: 10-character field. If ZLEXT=YES, contains the initial number of records; a number in the range 0 - 2147483647.
ZLLIB: Position in concatenated data set sequence; a number from 1 to 16.
ZLM4DATE: Last change date, a character variable shown in your national format with a 4-character year. Use system variable ZDATEF to determine the national format. If no value exists for this variable, ISPF sets the value to blanks.
ZLMDATE: Last change date, a character value shown in your national format. Use system variable ZDATEF to determine the national format. If no value exists for this variable, ISPF sets the value to blanks.
ZLMNORC: Number of modified records; a number in the range 0 - 65535.
ZLMNORCE: 10-character field. If ZLEXT=YES, contains the number of modified records; a number in the range 0 - 2147483647.
ZLMOD: Modification level; a number from 0 to 99.
ZLMSEC: Seconds value of the last change time. This is a two character field.
ZLMTIME: Last change time; a character value in the format hh:mm.
ZLUSER: User ID of the last user to change the given member; an alphanumeric field with a maximum length of 7 characters. When the user ID of the last user to change the given member is an 8-character value, this variable contains the value '>7CHARS'; the 8-character user ID can be obtained from the ZLUSER8 variable.
ZLUSER8: User ID of the last user to change the given member; an alphanumeric field with a maximum length of 8 characters.
ZLVERS: Version number; a number from 1 to 99. If no value exists for this variable, ISPF sets the value to blanks.
ZSCLM: Indicates whether the member was last modified by SCLM or ISPF. A value of Y indicates the last update was made through SCLM. A value of N indicates that the last update was made through ISPF.

The preceding variables are stored in the function pool and therefore become immediately available to command invocations. You cannot use the VGET service to retrieve these variables, since VGET accesses the shared and profile pools.

For an MVS™ partitioned data set, if the statistics are not stored in the data set directory in the same format used by Edit, only ZLLIB is set with the position in the concatenation.

NOLLA

If LLA is used to manage a cached directory entry, specify this keyword to ensure that the cached entry is not used.

buf-len

A fullword fixed binary integer containing the length of the buffer parameter.

buffer

A buffer containing the name of the service and its parameters in the same form as they would appear in an ISPEXEC invocation for a command invocation.