TRANSFER Reference Manual

GET-AGENT-SELECT
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–229
AGENT-FLAG
determines whether the agent requires the associated TAREQ to begin a session on
its behalf before the agent can run.
Y Session initiation is required.
N Session initiation is not required.
APPLIC-ID-FOR-LOGON
is the application ID to be used in establishing the session when the AGENT-
FLAG is set to Y.
APPLIC-ID-LOW, APPLIC-ID-HIGH, AGENT-SEL-LOW, and AGENT-SEL-HIGH
define numeric ranges used to select the agent. These fields are used as noted in
the discussion of the ALTER-AGENT-SELECT UOW.
AGENT-DATA
is data that your application passes to the agent. The agent defines AGENT-
DATA content .
Note The default agent configuration screen allows you to view and modify the first 78 characters of the 80-
character AGENT-DATA field. If you provide an agent that requires 79 or 80 characters of agent data,
you must also provide a SCREEN COBOL program to configure the agent.
GET-AGENT-SELECT Operation
GET-AGENT-SELECT retrieves the requested agent selection entry from the depot
Profile file. The agent is identified by AGENT-REC-NUM. The list of agents for the
depot is arranged by agent record number. Existing agents can have AGENT-REC-
NUM values from 1 through 500. You can specify a value of 0 for the operation
specified by A in the ACTION field. A read operation returns the AGENT-REC-NUM
of the agent just read.
To read the list of agents in order, set AGENT-REC-NUM to 0 and then perform read-
after operations, using the most recently returned AGENT-REC-NUM until W-EOF
occurs in the RETN-CODE field.
For further information about agent selection criteria, see the discussion of the ALTER-
AGENT-SELECT UOW.