TRANSFER Reference Manual

GET-AGENT-SELECT
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–227
CORR-NAME
is the name of the correspondent represented by the calling process. You can
specify a partially qualified name, including wild-card characters. Only system
administrators can enter correspondent names other than their own in this field;
correspondents without system administrator privileges must enter their own
names or leave the field blank. In the response, the fully qualified name is
returned.
AGENT-REC-NUM
is the position of the record that defines the agent in the agent list for the depot.
This field is used with the ACTION field. In the response, the number of the
record accessed is returned.
ACTION
specifies which record should be read, relative to the value supplied in AGENT-
REC-NUM.
E Read the record denoted by AGENT-REC-NUM.
A Read the record following the record denoted by AGENT-REC-NUM.
If the record indicated by AGENT-REC-NUM does not exist, the warning W-EOF
is returned in the RETN-CODE field.
Typically, an application reads selection criteria for several agents. To read the
criteria for the first agent (record) in the agent list, for example:
1. Set AGENT-REC-NUM to 0.
2. Set ACTION to A.
To read the criteria for the next agent:
1. Set AGENT-REC-NUM to the value returned on the previous call.
2. Set ACTION to A.
In the response, no data is returned in this field. The field is included only to
simplify the use of the GET-AGENT-SELECT UOW response as an ALTER-
AGENT-SELECT request.