Parameters
- table-name
- Specifies the name of the table to be displayed.
- panel-name
- Specifies the name of the panel to be displayed.
- message-id
- Specifies the identification of a message to be displayed on the panel.
- field-name
- Specifies the name of the field where the cursor is to be placed on the display. Any setting of the .CURSOR control variable done in the panel definition takes precedence over this parameter.
- table-row-number
- Specifies the table row number (CRP number) corresponding to the
model set on the display where the cursor is to be placed. For a call,
this parameter must be a fullword fixed binary number.
Specifying the CSRROW parameter without specifying AUTOSEL(NO) results in the row being retrieved, even if the user did not explicitly select the row. This is called auto-selection.
If the specified row does not have a corresponding model set in the logical table display (the logical table display includes model sets not displayed because of split-screen, PFSHOW, or floating command line), the cursor is placed at the command field. No auto-selection is performed.
Any setting of the .CSRROW control variable done in the panel definition takes precedence over this parameter.
- cursor-position
- Specifies the position within the field where the cursor is to
be placed. This position applies regardless of whether the initial
cursor placement was specified in the CURSOR calling sequence parameter,
the .CURSOR control variable in the )INIT or )REINIT section of the
panel, or is the result of default cursor placement. If cursor-position
is not specified or is not within the field, the default is 1.
Any setting of the .CSRPOS control variable done in the panel definition takes precedence over this parameter.
- AUTOSEL( YES |NO)
- YES specifies that if the CSRROW(table-row-number) parameter is
specified or if .CSRROW is set within the )INIT or )REINIT section,
the row is to be retrieved, even if the user did not explicitly select
the row. This is known as auto-selection.
NO specifies that even if the CSRROW(table-row-number) parameter is specified or if .CSRROW is set within the )INIT or )REINIT section, the row is to be retrieved only if the user explicitly selects the row by entering data into the corresponding model set.
If the CSRROW parameter or the .CSRROW control variable is not specified, the AUTOSEL parameter is ignored.
Any setting of the .AUTOSEL control variable done in the panel definition takes precedence over this parameter.
- crp-name
- Specifies the name of a variable in which the row number pointed to by the CRP is to be stored. If the CRP is positioned to TOP, the row number returned is zero.
- rowid-name
- Specifies the name of a variable in which a number that uniquely identifies the row being accessed is to be stored. Later, this identifier can be specified in the ROW parameter of TBSKIP to cause the CRP to be positioned to the row. This identifier is not saved on permanent storage by TBSAVE or TBCLOSE. The variable must be an 8-byte character field.
- message-field-name
- Used to position the message pop-up window. If the application specifies this parameter, the
Dialog Manager positions the message pop-up relative to the named field.
If this parameter is omitted and a message is displayed in a message pop-up window, the window is displayed at the bottom of the logical screen or below the active ADDPOP pop-up window if one exists.
For compatibility with later versions, this parameter should be specified only when the message will display in a pop-up window.
- buf-len
- Specifies a fullword fixed binary integer containing the length
of
buffer
. - buffer
- Specifies a buffer containing the name of the service and its parameters in the same form as they would appear in an ISPEXEC call for a command procedure.