SEND CONTROL - IBM Mainframe

This command will send device controls to a terminal without map or text data. The keywords are separated by their supported BMS functions (Minimum, Standard, or Full). The syntax of the SEND CONTROL command is given below:

Minimum BMS

Minimum BMS

Minimum BMS

Standard and Full BMS

Standard and Full BMS

An example of the full BMS is given below:

example of the full BMS

The options of the SEND CONTROL command are explained below:

  • ACCUM - This option notifies CICS that this command is part of several commands used in building a logical message. The message is completed by issuing the SEND PAGE command, or deleted by issuing the PURGE MESSAGE command.
  • ACTPARTN (name) - Character field (1-2 bytes) containing the name of the partition to be activated. Partition activation moves the cursor into the specified partition, and unlocks the keyboard for the specified partition. If the terminal does not support the partition feature then the option is ignored.
  • ALARM - Option when used will activate the 3270 audible alarm feature. This option instructs BMS to set the alarm flag in the FMH for logical units that support FMH's (except interactive and batch logical units).
  • CURSOR (data_value) - Halfword binary (PIC 9(4) COMP) containing the cursor position location relative to zero for a 3270 or 3604 device type. The value range depends on the size of the screen. The data value for the cursor location must be a positive value, a negative value will lead to unpredictable results. When omitted the cursor default is position zero of the screen. When ACCUM is used with this option, the most recent value of CURSOR specified is used to position the cursor.
  • ERASE - This option will position the cursor in the upper left comer of the screen after erasing the screen printer buffer or partition. This option is only valid for 3270 or 8775 devices and the 3604 Keyboard Display. This is normally specified on the first output operation in any transaction, or in a series of pseudo conversational transactions, which when used will ensure that the correct screen size is selected, as defined in the RDO (Resource Definition On-line) file. When switching from one screen size to another on a transaction basis, if the ERASE option is not executed on the first output command of the transaction then the screen size remains unchanged from the previous transaction setting, or the default screen size if the CLEAR key was pressed.
  • ERASEAUP - Option will erase all unprotected character locations for the partition or the entire screen is to be erased. This option is only valid for 3270 and 8775 devices.
  • FORMFEED - Indicates a new page is required. The FORMFEED control character for display devices and 3270 printers are placed at the beginning of the buffer. After placing the control character in the buffer, care must be taken by the application program not to over write the control character by a map or text data. If the terminal definition does not specify this option then it is ignored.
  • FREEKB - Option will unlock the 3270 keyboard. If omitted, the keyboard remains locked. The keyboard lock status is maintained independently for each partition on a terminal that supports partitions.
  • FRSET - The modified data tags (MDTs) of all the fields in the current 3270 buffer or partition buffer are reset to the unmodified condition (field reset). When no other ATTRIBUTE information is written in the symbolic map, this option gives the ATTRB operand of DFHMDF for the next requested map, control over the final status of fields written or rewritten in response to a BMS command.
  • HONEOM - This option when used indicates the default printer line length is to be used. The default length should be equal to the value specified in RDO options PAGESIZE or ALTPAGE, or PGESIZE or ALTPGE of the entry TYPE=TERMINAL and the same as the printer platen width; otherwise data formatting problems may occur.
  • LAST - Indicates that for the transaction, this is the last output operation for a transaction and as a result the end of a bracket. This option only applies to logical units.
  • LDC (name) - Character field (2 bytes) identifying the mnemonic used in determining the suitable logical device code (LDC) numeric value. The mnemonic represents a LDC entry in the terminal control table TYPE=LDC. When using this option, BMS will use the device type, page size, and page status associated with the LDC mnemonic when formatting the message. The value used for the LU are used from the local extended LDC table when present, otherwise the values are used from the system LDC table when only a local (unextended) LDC is present.
  • L40 - Defines a 3270 printer line length. The characters for a carrier return and line feed are added after 40 characters have been printed. Results may be unacceptable if this option differs from the "page width definition set-up in the RDO or TCT TYPE=TERMINAL definition.
  • L64 - Defines a 3270 printer line length. The characters for a carrier return and line feed are added after 40 characters have been printed. Results may be unacceptable if this option differs from the page width definition set-up in the RDO or TCT TYPE=TERMINAL definition.
  • L80 - Defines a 3270 printer line length. The characters for a carrier return and line feed are added after 40 characters have been printed. Results may be unacceptable if this option differs from the page width definition set-up in the RDO or TCT TYPE=TERMINAL definition.
  • MSR (datavalue) - Character field (4 bytes) containing the value that controls the 10/63 magnetic stripe reader attached to an 8775 or 3643 terminal. DFHMSRCA provides a set of constants in assisting the setting of this 4-byte area. The option is ignored when either the RDO option MSRCNTRL was omitted, or the TCT does not specify FEATURE=MSRCNTRL
  • OUTPARTN (name) - Character field (1-2 bytes) containing the partition name where the data will be sent. The option is ignored for either of the following reasons:
    • The terminal does not support partitions
    • No application partition set associated with the terminal
  • When the OUTPARTN option is omitted, and there is an application partition set, then the data is sent to the partition named by the PARTN option of the DFHMSD (map definition macros). The output is sent to the first partition in the set when either map is not used or if there is no PARTN operand.

  • PACING - Indicates that instead of sending the output immediately to the terminal, the data is placed in temporary storage and displayed in response to a paging command entered by the terminal operator. When PAGING is used with the REQID option (defined as recoverable in the Temporary Storage Table), CICS then provides local messages with message recovery when the task reaches a syncpoint.
  • PRINT - Indicates that the print operation is started for any of the following:
    1. 3270 printer
    2. 3275 with the printer adapter feature
    3. LUTYPE2 (3274/76 or 3790) data will be printed on an allocated controller printer.When omitted, the data is sent to the printer buffer but is not printed.
  • REQID (name) - Character field (2 bytes) containing the prefix (default is '**') to be used as part of the temporary storage identifier for CICS message recovery. For each local message, only one prefix can be used. BMS message recovery is only valid for a local message when the PAGING option is used on a BMS SEND command and a syncpoint has been reached.
  • SET (ptr-ref) - Set the pointer reference value to the address of the output data. The set option specifies that the completed pages are to be returned to the application program. The pointer is set to the address of the list of completed pages. ;
  • TERMINAL - Specifies that the output data is to be sent to the terminal that initiated the transaction.
  • WAIT - Specifies that the control should not be returned to the application program until the output operation has been completed. If WAIT is not specified control will return to the application program, once the output operation has started.
  • Handle Conditions:

  • ICREQCD - A LUTYPE4 logical unit receives a SIGNAL data flow control command with a request change direction (RCD) code and then the application program attempts to execute a SEND command. The default action is the abnormal termination of the task.
  • ICREQID - Condition is set when the prefix used in the REQID option is different from one previously established with the REQID option or by default ('**') for this logical message.
  • The default action is the abnormal termination of the task.

  • INVLDC - Condition is set when the LDC mnemonic being used is missing in the LDC list for the logical unit. The default action is the abnormal termination of the task.
  • INVPARTN - Condition is set when the specified partition is not defined in the partition set associated with the application program. The default action is the abnormal termination of the task.
  • INVREQ - Occurs for any of the following reasons:
    1. Control information is output to the same partition or LDC as mapped data while a BMS logical message is active. If neither partitions nor LDCs are in use, control information is output to the same device as mapped data.
    2. For a distributed program link server application attempted to send data on its function-shipping (principal facility) session.
  • The default action is the abnormal termination of the task.

  • RETPAGE - When using the SET option and a completed page is ready to be returned to the application program, then this condition is triggered. When this handle condition occurs the control is returned to the next statement following the BMS SEND command in the application program by default.
  • TSIOERR - Condition is set when there is an irrecoverable temporary storage input/output error. The default action is the abnormal termination of the task.
  • WRBRK - Condition is set when the command is interrupted by the terminal operator pressing the ATTN key. This option is only valid on a 2741Communication Terminal with the write break supported for CICS. The default action Is the abnormal termination of the task.


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM Mainframe Topics