VPUTL


This command creates or sets a long variable from a variable in the TSO pool.


Important

This command supports the use of sysplex variables; refer to Using-sysplex-variables for more information about restrictions with sysplex variables (such as with wildcard characters and abbreviations) and other important information.

This variable operation only supports a subset of the functions available for the short variables. For example, no target system functionality is provided. It ONLY affects and searches for long variables. If a short variable (created with VPUT instead of VPUTL) with the specified name exists, it is ignored.

Command

Parameters

VPUTL

variableName | (var1... varN)

[LOCAL|SHARED|PROFILE]

The following table describes the parameters:

Parameter

Function

Notes

variableName | (var1 ... varN)

Name of one or more variables

Each variable name can be up to 30 characters. The maximum length of the combined variable values is 252 bytes.

Variables beginning with the character Q are reserved for system variables and may not be modified.

Pool identifier

Pool in which the designated variables reside

One of the following pools:

SHARED is the default.

Condition codes are listed in the following table:

Value

Description

0

The variable existed in the target pool and has been overwritten.

4

The variable did not exist in the pool and has been created.

This return code does not occur for sysplex variables. You will receive a RC of 0 whether or not the variable previously existed.

8

Error occurred during operation (possible out-of-space condition for the PROFILE pool).

12

Attempt was made to set a read-only variable (for example, Q-type variable was specified that cannot be VPUT).

16

Syntax error occurred.

16

Sysplex variable name is too long (exceeds 13 characters, the limit for long sysplex variable names)

20

Variable pool was not found. BBIVARS was not allocated.

Example

a='This is a test'

"IMFEXEC VPUTL A SHARED"

CLIST example:

SET A=&STR(This is a test)
IMFEXEC VPUTL A SHARED

This section contains the following topic: 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*