Previous Topic: FieldsNext Topic: Selection Codes


Input Commands

The following input commands are available on the Distribution Selection List panels:

CONFIRM

Enables or disables the display of the Confirm Delete panel when definition data is to be deleted using the D selection code. The default is ON. Confirmation is automatically enabled when a new command is entered on the Primary Selection Menu panel.

The syntax of the CONFIRM command is as follows:

CONFIRM  [ ON | OFF ]

Where:

ON

Indicates to enable the Confirm Delete panel. No subsequent delete requests are processed without requesting user confirmation.

OFF

Indicates to disable the Confirm Delete panel. All subsequent delete requests are processed without requesting user confirmation.

LEFT

Toggles between the two active displays.

LOCATE

Scrolls to the entry whose name you specify as the operand of the command; if the specified name is not in the list, scrolls to the entry whose name immediately precedes that specified.

For sorted lists, the LOCATE command traverses the list based on the first or only sort field.

Valid entries are L, LOC, or LOCATE.

REDISP

Redisplays (or refreshes) a selection list with current information.

Because definition and active data can be concurrently updated and added by the started task, batch jobs, and online users, data displayed on a selection list can become outdated. Recent changes and newly added data are obtained when the REDISP command is entered.

The syntax of the REDISP command is as follows:

REDISP  [ ON | OFF ]

Where:

ON

Indicates that the display is to be refreshed automatically when the Enter key is pressed

OFF

Indicates that the REDISP command must be entered to refresh the display

The ON and OFF parameters are temporary overrides to the REDISP initialization parameter setting and are only retained for the duration of the session. If the ON/OFF parameter is omitted, the display is refreshed without altering the current ON/OFF state.

For sorted lists, you must specifically enter the REDISP command to refresh the display. Valid entries are RED, REDISP, REF, and REFRESH.

RIGHT

Toggles between the two active displays.

SELECT

Selects the distribution identifier or distribution list you specify as the operand of the command for display

The syntax of the SELECT command is as follows:

SELECT id [ LIST | L ]

If the specified distribution identifier or distribution list does not exist, an entry is created for it.

To create a distribution list, specify the LIST or L operand.

Valid entries are S, SEL, and SELECT.

SORT

Sorts the selection list display by distribution identifier, date/time entry was last changed, the user who last changed entry, or address line

Up to two fields can be sorted.

The syntax of the SORT command is as follows:

SORT field1 field2

The following field names can be referenced on the SORT command and the predefined sort sequence used to order the data.

DISTID

Sorts by distribution identifier

You can enter DISTID as DID or D.

Sort Sequence: Ascending

CHANGED

Sorts by date/time last changed

You can enter CHANGED as CHA or C.

Sort Sequence: Descending

USER

Sorts by user/job that last changed entry

You can enter USER as U.

Sort Sequence: Ascending

LINE

Sorts by address line

You can also specify LINE as DESC.

Sort Sequence: Ascending

To sort the selection list by address line, enter the command:

sort line

To sort the selection list by user who last changed entry and date/time entry was last changed, enter the command:

sort user cha  

After the list is sorted, you can use the LOCATE command to traverse the list based on the first or only sort field. For example, if the list is sorted by address line, LOCATE SMITH scrolls the list to the entry or closest entry whose first address line is SMITH.

If the SORT command is entered by itself without a field, the standard dynamic list, which is sequenced by distribution identifier, displays.