z/OS MVS Programming: Sysplex Services Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


How to Request a Macro Version

z/OS MVS Programming: Sysplex Services Reference
SA38-0658-00

To request a version of a macro, use the PLISTVER keyword. PLISTVER is the only parameter allowed on the list form of a macro form (MF), and it determines which parameter list the system generates. PLISTVER is optional. If you omit it, the system generates a parameter list for the lowest version that will accomodate the keywords specified. This is the IMPLIED_VERSION default.

You also have the option of coding a specific version number using plistver, or of specifying MAX.
  • plistver allows you to code a decimal value corresponding to the version of the macro you require. The decimal value you provide determines the amount of storage allotted for the parameter list.
  • MAX allows you to request that the system generate a parameter list for the highest version number currently available. The amount of storage allotted for the parameter list will depend on the level of the system on which the macro is assembled.

    IBM® recommends, if your program can tolerate possible additional growth, that you always specify PLISTVER=MAX when creating the list form parameter list. MAX ensures that the list form parameter list is always long enough to hold whatever parameters might be specified on the execute form.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014