SEND PAGE - IBM Mainframe

The SEND PAGE command will send the last page, which completed a BMS logical message. This action causes BMS to generate a device dependent data stream for the last page of data, which may be the only page, or only a partial last page of a set of pages. There are several options, which establish varying degrees of control over the logical message:

  • AUTOPAGE, NOAUTOPAGE, and OPERPURGE are used to specify how much control the terminal operator has over the disposition of the logical message
  • RELEASE or RETAIN are used in determining whether control should return to the application program after logical message transmission occurs
  • TRAILER is used in adding trailer data to a text logical message
  • SET is used in returning the device dependent data stream for the last logical message page to the application program If this is a paging message, the logical message last page is transmitted to temporary storage and the terminal operator paging transaction is initiated. If it's a terminal logical message, the last page is transmitted to the terminal. This is only supported by full BMS. The syntax of the command is given below:

syntax of the command is given below

SEND PAGE

The different options of the SEND PAGE command are explained below:

  • ALL - Specifies that while a BMS logical message transmission to a terminal is occurring, the terminal operator presses the ATTN key on a 2741, and the WRBRK. condition was not specified, transmission of the current page is to cease and no additional pages are to be transmitted. The logical message is deleted.
  • AUTOPAGE - Automatically send each completed page of a BMS logical message to the terminal as soon as its available. If paging on request is specified for the terminal by the PGESTAT operand of the TCT TYPE=TERMINAL, or the RDO option AUTOPAGE(NO) AUTOPAGE overrides it for this logical message. For 3270 printers this option is assumed. This option is invalid for 3270 display terminals. If neither AUTOPAGE nor NOAUTOPAGE is used, the terminals paging status is determined from the TCT TYPE=TERM1NAL or the RDO option AUTOPAGE.
  • CURRENT - Specifies that while a BMS logical message transmission to a terminal is occurring, the terminal operator presses the ATTN key on a 2741, and the WRBRK condition was not specified, transmission of the current page is to cease and if any other pages exist then transmission of the next page is to begin.
  • FMHPARM (name) - Character field (1-8 bytes) containing the name of the outboard map to be used. This option is only valid for 3650 logical units with outboard formatting abilities.
  • LAST - Indicates that for the transaction, this is the last output operation for a transaction and as a result the end of a bracket. When the option RELEASE is used, this option is assumed unless the SEND PAGE command is terminating a routing operation. This applies only to logical units.
  • NOAUTOPACE - Notifies CICS that the BMS logical message pages are to be sent one at a time to the terminal. The first page is sent to the terminal when the terminal becomes available or on request of the terminal operator. All subsequent pages are sent to the terminal in response to request's from the terminal operator. When automatic paging is defined for the terminal by the PGESTAT operand of the TCT TYPE=TERMINAL, then this option will override it for this logical message. For logical units, NOAUTOPAGE applies to all pages for all LDCs in the logical message. NOAUTOPAGE does not apply to 3270 printers.
  • OPERPURGE - Option notifies CICS to delete the BMS logical message only when the terminal operator requests the deletion. When the option is omitted, CICS will delete the BMS logical message if the operator enters data that is not a paging command.
  • RELEASE - Option indicates that control is to be returned to the program at the next higher logical level, or to CICS (if the issuing application program is at the highest logical level already), after the pages have been written to the terminal, upon completion of the SEND PAGE command.
  • RETAIN - Option signals to CICS that after the SEND PAGE command, control will be returned to the application program after the pages have been written to the terminal.
  • SET (ptr_ref) - Set the pointer reference value to the address of the output data. The option indicates the application program will receive the completed pages and the pointer reference address is set to the list of completed pages. The application program regains control either immediately following the SEND MAP command (if the current page is not yet completed), or at the label specified in a HANDLE CONDITION RETPAGE command, if the page has been completed. When TIOAPFX=YES is used in the map definition, the pointer will return the address of the storage accounting area (SAA).The user data starts at offset X'OC from the start of the SAA.
  • TRAILER (data_area) - Option signals CICS to attach to the bottom of the last page only the contents of the data area.
  • TRANSID (data_area) - Character field (1-4 bytes) containing the transaction identifier (name) that will be used with the next input message from the terminal to which the task is attached. Option is only valid when the SEND PAGE RELEASED is used. The transaction identifier must have been previously defined using the appropriate RDO program definition. Using this option when the application program is not at, the highest logical level causes the specified transaction identifier to be used only when a new transaction identifier is not provided in another SEND PAGE command (or in a RETURN program control command) issued in a program at a higher logical level.
  • Handle Conditions:

  • IGREQCD - 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 PAGE command. The default action is the abnormal termination of the task.
  • INVREQ - Condition is set for BMS services when any of the following is invalid:
    1. The disposition (TERMINAL, PAGING, or SET) of a BMS logical message is changed prior to its completion by the SEND PAGE command.
    2. While a BMS logical message is active, the application program tries to send text data as output to the same partition or LDC as mapped data. If neither partitions nor LDCs are in use, text data is output to the same logical message as mapped data.
    3. Option TRAILER is used when terminating a logical message built with SEND MAP commands only.
    4. While overflow processing is occurring, data is sent to a different LD from the LDC that caused page overflow.
    5. The trailer length is negative.
    6. Command is invalid for a distributed program link server program.
  • 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. Control is returned to the next statement following the BMS SEND command in the application program when this condition occurs.
  • 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