Parameters

The parameters are explained as follows:

SEARCH_BY=CONNTKN

SEARCH_BY=LU62TKN

Required input parameter that specifies the type of search for the information about work.

Use SEARCH_BY=CONNTKN to indicate that the information about work associated with the input connect token should be returned. The information returned is a list of LU 6.2 tokens, contained in LU62_LIST, and a return code.

Use SEARCH_BY=LU62TKN to indicate that information about work associated with the input list of LU 6.2 tokens (which the caller must provide in the LU62_LIST=lu62_list) should be returned.

You define the input list with the LU62_LIST and LU62_LISTSIZE keywords. The list must be the output of a prior call to IWMWQWRK specifying SEARCH_BY=CONNTKN.

The information returned is a return code indicating whether work reflected in any monitoring environment owned by the current home address space is associated with ANY LU 6.2 token in the list of token provided in the LU62_LIST.

CONNTKN=conntkn

Required input parameter for SEARCH_BY=CONNTKN that specifies the connect token returned by IWM4CON. The connect token (CONNTKN) must be owned by the current home address space.

To code: Specify the RS-type name or address in register (2)-(12), of a 32 bit field containing the connect token.

QUERYLEN=querylen

Required output parameter for SEARCH_BY=CONNTKN that specifies the number of bytes needed to contain the information for the input connect token (CONNTKN=conntkn).

To code: Specify the RS-type name or address in register (2)-(12), of a fullword containing the number of bytes to contain the information.

SUBSYS=subsys

SUBSYS=NO_SUBSYS

Optional input parameter for SEARCH_BY=LU62TKN that specifies the generic subsystem type (ie CICS®, IMS™) This keyword helps narrow the search for the matching LU 6.2 token further.

To code: Specify the RS-type name or address in register (2)-(12), of a 4 character field containing the generic subsystem type.

SUBSYSNM=subsysnm

SUBSYSNM=NO_SUBSYSNM

Optional input parameter for SEARCH_BY=LU62TKN that specifies the subsystem instance name. This keyword helps narrow the search for the matching LU 6.2 token further.

To code: Specify the RS-type name or address in register (2)-(12), of an 8 character field containing the subsystem instance name.

LU62_LIST=lu62_list

LU62_LIST=NO_LU62_LIST

Optional input/output parameter specifying the area for the list of LU 6.2 tokens when you specify CONNTKN. When you specify LU62TKN, this parameter is required.. To specify an input LU62_LIST, you must have previously invoked this macro to receive an output LU62_LIST, and provide the list on a subsequent invocation.

To code: Specify the RS-type name or address in register (2)-(12), of a character field specifying the area for the LU 6.2 token list.

,LU62_LISTSIZE=lu62_listsize

Required input parameter for LU62_LIST=lu62_list specifying the length of the area provided to contain the data returned by IWMWQWRK.

To code: Specify the RS-type name or address in register (2)-(12), of a fullword field containing the length of the LU 6.2 token list.

ASID_LIST=asid_list

ASID_LIST=NO_ASID_LIST

Optional input/output parameter that specifies an area for the list of ASIDs. Each entry (ASID) is 2 bytes. Only ASIDs for regions known to be involved in some work request are returned. Regions which could not be interrogated are reflected only in the SKIP_REGIONS parameter.

ASID_LIST=NO_ASID_LIST indicates that no list area is provided.

To code: Specify the RS-type name or address in register (2)-(12), of a character field specifying the area for the list of ASIDs.

ASID_LISTSIZE=asid_listsize

Required input parameter for ASID_LIST=asid_list that specifies the length of the area provided for the ASIDs returned by IWMWQWRK.

To code: Specify the RS-type name, or address in register (2)-(12), of a fullword containing the length of the area.

ASID_SIZENEED=asid_sizeneed

Required output parameter for ASID_LIST=asid_list that specifies the number of bytes needed for the output list of ASIDs.

To code: Specify the RS-type name or address in register (2)-(12), of a fullword to contain the number of bytes needed for the ASID list.

STOKEN_LIST=stoken_list

STOKEN_LIST=NO_STOKEN_LIST area is provided.

Option input/output parameter for that specifies the area for the list of STOKENs. Only STOKENs for regions known to be involved in some work request are returned. Regions which could not be interrogated are only reflected in the SKIP_REGIONS variable.

To code: Specify the name (RS-type), or address in register (2)-(12), of a character field specifying an area for the list of STOKENs.

STKN_LISTSIZE=stkn_listsize

Required input parameter for STOKEN_LIST=stoken_list that contains the length of the area provided for the STOKEN list being returned by IWMWQWRK.

To code: Specify the name (RS-type), or address in register (2)-(12), of a fullword containing the length of the area.

STKN_SIZENEED=stkn_sizeneed

Required input parameter for STOKEN_LIST=stoken_list that specifies the number of bytes needed for the output list of STOKENs.

To code: Specify the RS-type name or address in register (2)-(12), of a fullword containing the number of bytes.

SKIP_REGIONS=skip_regions

Optional output parameter for STOKEN_LIST=stoken_list that contains the number of address spaces skipped and therefore not included in the output list of ASIDs/STOKENs. If the caller wants to re-invoke IWMWQWRK when SKIP_REGIONS is non-zero, it may be desirable to ensure that ASID_SIZENEED + 2*SKIP_REGIONS <= ASID_LISTSIZE, AND that STKN_SIZENEED + 8*SKIP_REGIONS <= STKN_LISTSIZE when these output areas are passed.

,RETCODE=retcode addr

Optional output parameter that specifies where the system is to store the return code. The return code is also in GPR 15.

To code: Specify the name (RS-type) or address (using a register from 2 to 12) of a fullword to contain the return code.

,RSNCODE=rsncode addr

Optional output parameter that specifies where the system is to store the reason code. The reason code is also in GPR 0.

To code: Specify the name (RS-type) or address (using a register from 2 to 12) of a fullword to contain the reason code (if any).

,MF=S

,MF=(L,mfctrl,mfattr)

,MF=(E,mfctrl,COMPLETE)

Use MF=S to specify the standard form, which places parameters into an inline parameter list and invokes the IWM4CON macro service.

Use MF=L to specify the list form of the macro. Use the list form together with the execute form of the macro for applications that require re-entrant code. The list form defines an area of storage that the execute form uses to store the parameters.

Use MF=E to specify the execute form of the macro. Use the execute form with the list form of the macro for applications that require re-entrant code. The execute form stores the parameters into the storage area defined by the list form and generates the macro invocation to transfer control to the service.

,mfctrl

Use this output parameter to specify the name of the storage area to contain the parameters.

To code: Specify the name (RS-type) or address (using a register from 2 to 12) of the storage area containing the parameter list.

,mfattr

Use this input parameter to specify the name of a 1 to 60 character storage area that can contain any value that is valid on an assembler DS pseudo-op. You can use this parameter to force boundary alignment of the parameter list. If you do not code ,mfattr the system provides a value of 0D, which forces the parameter on a doubleword boundary.

,COMPLETE

Use this input parameter to specify that the system check for required parameters and supply defaults for omitted optional parameter.