Retrieve a page
The CSPG page retrieval command allows you to retrieve a specified page. If partitions are in use, the page retrieval command refers to the partition in which it has been entered.
About this task
- Getpage
- This is the user-defined identification code for the retrieval transaction, and is 1–7 characters long. This code is defined by the PGRET system initialization parameter. For convenience, make the code as short as possible; for example, P/.
- A
- You can ignore this option unless chaining is being used. It is
the level, within a chain of logical messages, of the logical message
to be retrieved. You must enclose it in parentheses. It can be one
of the following:
- n
- message is at level n
- +n
- message is n levels forward
- -n
- message is n levels backward
- P
- previous level backward
- C
- current level (the default)
- N
- next level forward
- L
- last level.
For more information about levels of messages, see Message chaining with CSPG.
- B
- Defines the next operation to be performed on the logical message
at the current level, or at the level specified by the A option it
can be one of the following:
- n
- page n
- +n
- page n pages forward
- -n
- page n pages backward
- P
- previous page
- C
- redisplay current page (after clearing the screen)
- N
- next page
- L
- last page
- A
- for an autopaging (that is, hard copy) terminal that is temporarily
in paging mode: return the terminal to autopaging mode and output
all remaining pages.
This is discussed further under Using Autopage with CSPG.
- X
- enter data that is not recognized as a paging command.
This is discussed further under Single keystroke retrieval (SKR).
- *ldc
- Is the LDC for the device to which you want to send the message. (See Page retrieval for logical devices.)
- *ALL
- A special case of *ldc.
- Hhhhhh
- Is the 6-digit hexadecimal identifier of an undelivered logical
message to be retrieved. You would normally determine this identifier
by entering a page query command (see Display information about logical messages).
If you do not specify an identifier, the oldest message is retrieved. After a paging session has started, you can omit hhhhhh because all subsequent pages are from the current message.
In the following examples, P/ is the page retrieval
transaction identifier:
- P/7
- Retrieve page 7 of this message.
- P/N
- Retrieve next page (following the one being displayed) of this message.
- P/(N)9
- Retrieve page 9 of the next message (of several that have been chained).