z/OS DFSMSrmm Application Programming Interface
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Specifying the option to free a resource

z/OS DFSMSrmm Application Programming Interface
SC23-6872-00

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).

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014