TRANSFER Reference Manual

ALTER-AGENT-SELECT
TISERV UOW Descriptions
2–66 069139, Update 1 to 40969 Tandem Computers Incorporated
ALTER-AGENT-SELECT Operation
ALTER-AGENT-SELECT creates, deletes, or updates the requested agent selection
entry recorded in the depot profile file. The agent is identified by AGENT-REC-NUM.
The selection entry is contained in fields AGENT-NAME through AGENT-DATA.
The list of agents for a depot is ordered by agent record number (AGENT-REC-NUM
field). Existing agents can have AGENT-REC-NUM values in the range of 1 through
500.
The AGENT-REC-NUM values are numbered consecutively. Deleting an agent causes
the AGENT-REC-NUM of all subsequent agents to decrease by one. Inserting an agent
causes the AGENT-REC-NUM of all later agents to increase by one.
To insert a new agent after an existing agent, set the ACTION field to I and the
AGENT-REC-NUM field to the record number of the existing agent.
To insert an agent at the beginning of the agent list, set the ACTION field to I and the
AGENT-REC-NUM field to 0.
A write operation returns the AGENT-REC-NUM of the agent just written. Thus, an
insert operation returns the record number of the agent just inserted; the number is
one greater than the number you provided in the insert request. To add the next agent
to the end of the list, you should use the returned record number in the next
ALTER-AGENT-SELECT UOW.
To delete an agent, you need only supply the following information:
Set SELF-IDENT to UW.
Set UOW-CODE to 208.
Set ACTION to D.
Set AGENT-REC-NUM to the record number.
A delete operation returns either of the following:
Zero if no agent exists after the one just deleted.
The number of the next remaining agent, which is a value equal to that provided
in the delete request.