You can free a resource when you no longer need to use it by performing
one of these actions:
- Use the OPERATION=RELEASE and TOKEN=token parameters to free all resources associated with the specified token
as shown in Figure 1.
Figure 1. TOKEN= specified on EDGXCI***************************************************
** Done with the subcommand, setup release parmlist
***************************************************
EDGXCI MF=(M,RELPL,NOCHECK),PLISTVER=MAX, X
APIADDR=APIMOD@,OPERATION=RELEASE
***************************************************
** Call the DFSMSrmm API
***************************************************
EDGXCI MF=(E,RELPL,NOCHECK),TOKEN=TOKENA
Specifying TOKEN=TOKENA on the EXECUTE form of EDGXCI causes
the 4-byte TOKENA area to be set to all zeros upon return from freeing
the token.
TOKEN=token is required
even when you specify MF=(E,label,NOCHECK), unless you also specify
OPERATION=ENDALL. Specifying TOKEN=token causes the 4-byte token area to be updated upon return from the
DFSMSrmm API. The token is set to all zeros by the EDGXCI macro expansion.
- Specify the OPERATION=ENDALL parameter to free all resources associated
with all tokens, as shown in Figure 1.
Rule: You are responsible for setting applicable tokens
to all zeros when you specify OPERATION=ENDALL.
- Your application program ends (end-of-task occurs).