Parameters

name-list

Specifies the names of one or more dialog variables whose values are to be copied from the shared or profile pool to the function pool. The names are passed in the standard name-list format.

ASIS

Specifies that the variables are to be copied from the shared pool or, if not found there, from the profile pool.

SHARED

Specifies that the variables are to be copied from the shared pool.

PROFILE

Specifies that the variables are to be copied from the application profile. A shared pool variable with the same name is deleted, even if it is not found in the profile pool.

SYMDEF

The values for the variables defined by name-list are to be obtained from the system symbols.

SYMNAMES(symname-list)

symname-list lists the names of one or more system symbols that are to be obtained. It is specified in the same format as the name-list parameter. Where symname-list is omitted, the system symbols obtained are the same as those specified on the name-list parameter.

One reason why you might use the SYMNAMES parameter is that some system symbols may have the same name as a reserved or read-only dialog variable. In this case you must specify a different variable name in name-list and specify the actual symbol name in symname-list. For example, SYSCLONE is a read-only dialog variable in a CLIST. Therefore, this command would work within a REXX exec, but it would fail in a CLIST:

VGET (SYSCLONE) SYMDEF

Instead, you could specify the command to obtain the current value for the static symbol SYSCLONE and store it in a variable named CLONE:

ISPEXEC VGET (CLONE) SYMDEF SYMNAMES(SYSCLONE)

If there are fewer symbol names in symname-list than names in the name-list, then the symbol names are used from the symname-list until there are no more corresponding symbol names, then the remaining names in the name-list are used. In other words, if there are five names in name-list and only three symbol names, the symbol names are used for the first three symbols and the last two names in the name-list are used for the remaining symbols.

If the number of symbol names in symname-list exceeds the number of names in name-list, a severe error occurs.

This is an optional parameter. It is only valid when the SYMDEF parameter is also specified.

buf-len

Specifies a fullword fixed binary integer containing the length of "buffer".

buffer

Specifies a buffer containing the name of the service and its parameters in the same form as they would appear in an ISPEXEC call for a command procedure.