Retrieving the JES XCF Group Token

To use the JES-defined attachment, you must retrieve and use the JES XCF group token. It identifies both the JES member and the JES XCF group name.

Most of the JES XCF macros require either the JES-defined group's group token or the installation-defined group's group token as input. If you intend to use the JES-defined attachment, obtain the group token from the control block fields specified in Table 1. If, however, you intend to establish your own attachment to XCF, use the group token returned by macro IXZXIXAT as described in Creating an Installation-Defined Attachment to JES XCF (IXZXIXAT Macro). Depending upon the JES under which you are running, retrieve the JES XCF token from the appropriate field as follows:

Table 1. JES Control Block from Which to Retrieve the JES XCF Group Token
JES	Field Name in Data Area
JES2	$XCFIXVT in $HCT CCTIXVT in $HCCT
JES3	SVTJXGT in IATYSVT TVTXJXGT in IATYTVTX
JES3 FSS	FSCBJXGT in IATYFSCB

If you use the IXZXIXAT macro to attach your own JES XCF group, IXZXIXAT returns a group token in the field you specified with the GROUPTOKEN= keyword on the IXZXIXAT macro call. Simply use the group token as input to other JES XCF macro calls.

After retrieving the token, make it available to your other programs that will use the JES XCF macros. When your other programs subsequently use the JES XCF macros, they must provide the group token as input. However, if you detach an installation-defined member from JES XCF, be certain to clear the group token field in your program; it will no longer be valid.