HCREQUEST

Description

Defines the sequence of characters, or function or attention key or lightpen, which invokes a screen hardcopy.

This common end-user parameter is applicable to these control statements: SYSTEM (see SYSTEM statement), PROFILE (see PROFILE statement), USER (see USER statement), and TERMINAL (see TERMINAL statement).

Format

HCREQUEST escape [CURSOR row col]

Usage and subparameter

escape, which must be delimited by a null or a space when issued, may be from one to eight characters long, PF1-PF24, PA1-3, ATTN, CLEAR or PEN.

By defining the Menu panel appropriately, using a defined input field (variable t_hcmd) the escape sequence can be modified dynamically. See the PANEL statement in the Panels, Scripts and Variables manual.

CURSOR row col

If this optional subparameter is specified, the hardcopy only occurs when the cursor is in the specified row and column. This applies to PF key and lightpen escapes as well as to character sequences. The effect is to stop IBM Session Manager from interpreting valid input to the session as a hardcopy request, but still allows a hardcopy to be taken.

Notes:

  1. The HCREQUEST parameter is affected by parameters CMDACTIONKEY and COMMANDPRFXVAL (see CMDACTIONKEY and COMMANDPRFXVAL).
  2. An alternative way to take a screen hardcopy is to use the HARDCOPY command. For details, see 'General user commands' in the Technical Reference manual.

Parent topic:

Related topics: