CHANGE.PFK command operands

pfk_number

The number of the PF key to be changed. If you specify a number that does not exist on your terminal, the Session Manager still accepts this operand. It has no way of knowing how many PF keys you have.

definition_text_string

The string of characters that are to be placed in the specified stream. If the text string contains lowercase letters, blanks, commas, or parentheses, enclose it in single quotation marks. A single quotation mark in the text string must be represented as two adjacent quotation marks.

If there are no blanks, commas, or parentheses in the text string, you can omit the enclosing quotation marks. If you omit the quotation marks, however, the Session Manager translates the text string to uppercase letters. When using the CHANGE.PFK command in a CLIST, the Session Manager always stores the text string in uppercase letters, even if it is enclosed in quotation marks.

If you enter more than one command for the text string, separate them with a semicolon (;).

If you want to use a PF key defined under some other 3270 application (for example, VS/APL), first define the definition_text_string for the PF key as null to the Session Manager. The PF key can then be passed back to the application. To specify a null PF key, define the definition_text_string as two adjacent quotation marks ('').

stream_name

The name of the stream where the text string is to be placed.

SUBSTITUTE

specifies that the information read from the screen is to be substituted into the ‘definition_text_string’, replacing the symbolic arguments.

identifier: identifies the symbolic argument that is to be replaced. Any character (except a blank or comma) can be used as the identifier. If the identifier character appears elsewhere in the definition_text_string, it must be doubled.
delimiter: separates the information about the screen that is to be substituted into the text string. One or more blanks are treated as a single delimiter. The delimiter can be any character except a comma.