ADMSETINFO
8.7
The ADMSETINFO instruction sends data to a Sunbelt administrative task from a PL/B Client program. The instruction uses the following format:
|
|
|
|
|
Where:
label
Optional. A Program Execution Label.
action
Required. A Numeric Variable, literal, or decimal number defining the action from the table below.
type
Required. A Numeric Variable, literal, or decimal number indicating the type of information.
value
Required. A Character String Variable or literal.
Flags Affected: ZERO
Note the following:
This verb is only available when running as a PL/B Application Server client. Other runtimes will disregard this instruction.
{action} is a number or keyword as defined in ADMEQU.INC indicating the type of
action. Valid values are:
|
Value |
Label |
The action is to ... |
|
1 |
$ADMADD |
add one entry of {type} with {value}. |
|
2 |
$ADMDELETE |
remove one entry matching the {type} and {value}. |
|
3 |
$ADMREPLACE |
replace one entry matching the {type} with the {value}. |
|
4 |
$ADMLOG |
place the {value} string into the server's log file. This action command allows storage of application log records directly into the log file of a server. |
The {type} parameter may be a reserved system defined value corresponding to the values referenced in the ADMGETINFO child data types. This allows a client program to modify its own child server settings. Any value other than a system defined, child data type value is considered a user-defined value. It is recommended that user-defined values range between 1000 and 2000 to prevent any conflict with system defined values.
For an $ADMLOG action, the {type} is the log level and must be zero (0).
{value} can be any text data.
An {action} of $ADMDELETE will remove one entry matching the {type} and {value} while an action of $ADMREPLACE will replace one.
The ZERO flag is set to indicate that the command was syntactically correct. It does not indicate the success or failure of the command.
See Also: System Interface Instructions
|
|