TRANSFER Reference Manual

ALTER-AGENT-SELECT

TISERV UOW Descriptions

2–64 069139, Update 1 to 40969 Tandem Computers Incorporated

APPLIC-ID-FOR-LOGON

is the application ID to be used in the START-SESSION UOW when the AGENT-

FLAG field is set to Y, meaning that a session is started before the agent is

invoked.

APPLIC-ID-LOW, APPLIC-ID-HIGH, AGENT-SEL-LOW, and AGENT-SEL-HIGH

define numeric ranges used by TAREQs to select an agent. These fields can

contain values ranging from 0 through 9999. Agent selection is as follows:

1. TAREQ examines the list of agents for a depot and compares the APPLIC-ID

submitted with the package against the range defined by APPLIC-ID-LOW

and APPLIC-ID-HIGH in the agent selection criteria. If the submitted

APPLIC-ID falls within this range, TAREQ continues to Step 2; otherwise, the

agent is not selected for execution. In these fields, the values 100 through 999

are reserved for Tandem.

2. If the APPLIC-ID submitted with the package falls within the range defined by

APPLIC-ID-LOW and APPLIC-ID-HIGH, TAREQ compares the AGENT-SEL

field submitted with the package against the range defined by AGENT-SEL-

LOW and AGENT-SEL-HIGH. If the submitted AGENT-SEL falls within this

range, TAREQ invokes the agent.

AGENT-DATA

is data that your application passes to the agent; its use is defined by the agent

itself.

Note The default agent configuration screen allows for viewing and modifying only the first 78 characters of the

80-character AGENT-DATA field. If you are providing an agent that requires 79 or 80 characters of agent

data, you must also provide a SCREEN COBOL program for configuring such agents.

RETN-CODE

is the return code. TISERV returns a code in this field to indicate one of the

following entries.

To indicate successful alteration of the agent selection criteria:

0 OK