This program creates a new agent. A Job manager ID is generated and returned to the caller.
Parameters
Parameter |
Type |
Description |
Id |
NUM_BIN_4 |
O - Job manager ID of the agent.
|
Name |
ALPHA(50) |
I - Name of the agent.
|
Description |
ALPHA(250) |
I - Description of the agent.
|
TargetServer |
ALPHA(250) |
I - Requested execution server (Job manager name or blank (*ANY)).
|
StartMode |
ALPHA(1) |
I - Start mode.
|
RestartCount |
NUM_BIN_2 |
I - Number of authorised failures before restart attempts stop.
|
Pgm |
ALPHA(250) |
I - Service program.
|
Parameter1 |
ALPHA(1024) |
I - Parameter 1 of the program.
|
Parameter2 |
ALPHA(1024) |
I - Parameter 2 of the program.
|
ReturnCode |
NUM_BIN_4 |
O - Return code of the program.
|
The program field contains the name of the program to be run.
The program must adhere to the following calling convention: program <parameter1> <parameter2> <job id>, identical to job programs, which facilitates porting from a job program to an agent program.
This program must interface with the Job manager database in order to update the report (using the TR_ADD_REPORT interface program, for example).
However, the state of the agent (stop/error notification/status text, etc.) is managed using the functions of the GsAgentDLL file.
Parameters 1 and 2 are alpha fields with a maximum length of 1024 characters.
