Send last page of data. Only supplied by full BMS. For further information
about BMS, see the CICS® Application Programming Guide.

SEND PAGE
>>-SEND PAGE--+-RELEASE--+---------------+-+-------------------->
| '-TRANSID(name)-' |
'-+--------+-----------------'
'-RETAIN-'
>--+--------------------+--+--------------+--------------------->
'-TRAILER(data-area)-' '-SET(ptr-ref)-'
>--+-----------------------+--+-----------+--------------------->
+-AUTOPAGE--+---------+-+ '-OPERPURGE-'
| +-CURRENT-+ |
| '-ALL-----' |
'-NOAUTOPAGE------------'
>--+---------------+--+------+---------------------------------><
'-FMHPARM(name)-' '-LAST-'
Conditions: IGREQCD, INVREQ, RETPAGE, TSIOERR,
WRBRK
Description
SEND PAGE completes a BMS logical message. It causes BMS to generate a
device-dependent data stream for the last (perhaps the only) page of data.
Typically, this last page is only partially full.
Options can be included to specify how much control the terminal operator
should have over the disposition of the logical message (AUTOPAGE, NOAUTOPAGE,
and OPERPURGE), to determine whether control should return to the application
program after transmission of the logical message (RELEASE or RETAIN), to
add trailer data to a text logical message (TRAILER), and to return the device-dependent
data stream for the last page of a logical message to the application program
(SET). If this is a paging message, the last page of the logical message is
transmitted to temporary storage and the terminal operator paging transaction
is initiated. If it is a terminal logical message, the last page is transmitted
to the terminal.
This is supported by full BMS only.
Options
- ALL
- specifies that if the ATTN key on a 2741 is pressed while a BMS logical
message is being sent to the terminal, and the WRBRK condition is not active,
transmission of the current page is to cease and no additional pages are to
be transmitted. The logical message is deleted.
- AUTOPAGE
- specifies that each page of a BMS logical message is to be sent to the
terminal as soon as it is available. If paging on request is specified for
the terminal by the RDO TYPETERM option AUTOPAGE(NO), AUTOPAGE overrides it
for this logical message.
AUTOPAGE is assumed for 3270 printers; it does
not apply to 3270 display terminals. If neither AUTOPAGE nor NOAUTOPAGE is
specified, the terminal has the paging status specified for it using the RDO
TYPETERM option AUTOPAGE.
- CURRENT
- specifies that if the ATTN key on a 2741 is pressed while a BMS logical
message is being sent to the terminal, and the WRBRK condition is not active,
transmission of the current page is to cease and transmission of the next
page (if any) is to begin.
- FMHPARM(name)
- specifies the name (1–8 characters) of the outboard map to be
used. This option applies only to 3650 logical units with outboard formatting.
- LAST
- specifies that this is the last output operation for a transaction and,
therefore, the end of a bracket. If RELEASE is specified, LAST is assumed
unless the SEND PAGE command is terminating a routing operation. This option
applies to logical units only.
- NOAUTOPAGE
- specifies that pages of a BMS logical message are to be sent one at
a time to the terminal. BMS sends the first page to the terminal when the
terminal becomes available or on request of the terminal operator. Subsequent
pages are sent to the terminal in response to requests from the terminal operator. (Refer to the CICS Supplied Transactions for more information
about terminal operator paging commands.)
If automatic paging is specified
for the terminal by the RDO TYPETERM option AUTOPAGE(YES), NOAUTOPAGE overrides
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
- specifies that CICS is to delete the BMS logical message only when the
terminal operator requests deletion. If the option is omitted, CICS deletes
the message if the operator enters data that is not a paging command.
- RELEASE
- specifies that, after the SEND PAGE command, control is to be returned
to CICS.
- RETAIN
- specifies that after the SEND PAGE command, control is returned to the
application program when the
operator has finished displaying the pages.
- SET(ptr-ref)
- specifies the pointer to be set to the address of the output data.
The SET option specifies that the last or only page is
returned to the application program. The pointer is set to the address of
the current page. A list of addresses is created and, if the ROUTE command
is in operation, there is an address entry for each device. If the ROUTE command
is not in operation, the list contains only the one entry. See
the description of the SET option in the section about full BMS in the CICS Application Programming Guide for more guidance on using the SET option.
The application program regains control either immediately following
the SEND PAGE 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.
If TIOAPFX=YES is specified in the map
definition, the pointer returned contains the address of the TIOA prefix.
The user data starts at offset X'0C' from the start of the TIOA prefix.
- TRAILER(data-area)
- specifies the text data area that contains trailer data to be placed
at the bottom of the last page only. The format of the trailer is:
- 2 bytes
- Binary length of the data (n)
- 2 bytes
- Binary zero
- n bytes
- Data.
See the CICS Application Programming Guide for more information.
- TRANSID(name)
- specifies the transaction identifier (1–4 alphanumeric characters)
to be used with the next input message from the terminal the task is attached
to. The identifier must have been defined to CICS via a RDO TRANSACTION resource
definition. TRANSID is valid only if SEND PAGE RELEASE is specified.
If
this option is specified in a program that is not at the highest logical level,
the specified transaction identifier is used only if 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.
Conditions
- IGREQCD
- occurs when an attempt is made to execute a SEND PAGE command after
a SIGNAL data-flow control command with a request change direction (RCD) code
has been received from an LUTYPE4 logical unit.
Default action: terminate
the task abnormally.
- INVREQ
- RESP2 values:
- 200
- Command not allowed for a distributed program link server program.
also occurs (RESP2 not set) in any of the following situations:
- The disposition (TERMINAL, PAGING, or SET) of a BMS logical message is
changed prior to its completion by the SEND PAGE command.
- Text data 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,
text data is output to the same logical message as mapped data.
- The TRAILER option is specified when terminating a logical message built
with SEND MAP commands only.
- During overflow processing data is sent to a different LDC from the LDC
that caused page overflow.
- The length of the trailer is negative.
Default action: terminate the task abnormally.
- RETPAGE
- occurs if the SET option is specified and the last
or only completed page is ready for return to the application program.
Default action: return control to the application program at the point
immediately following the BMS SEND PAGE command.
- TSIOERR
- occurs if there is an unrecoverable temporary storage input/output error.
Default action: terminate the task abnormally.
- WRBRK
- occurs if the SEND PAGE command is interrupted by the terminal operator
pressing the ATTN key. It applies only to the 2741 Communication Terminal,
and only if write break is supported for CICS.
Default action: ignore
the condition.