AAMDEX

9.0

The AAMDEX instruction provides all of the capabilities of the SUNAAMDX utility. The instruction uses the following syntax:

Where:

label

Optional. A Program Execution Label.

cmd

Required. A Character String Variable or Literal containing the command string.

{ip}

Optional. A Character String Variable or Literal defining the TCP/IP address and port number of the SUNDM Data Manager where the instruction is executed.

{cancel}

Optional. A Numeric Variable, decimal number, or a BUTTON object that identifies a user interface that cancels the processing for the instruction.

{dlist}

Optional. A DATALIST object that receives operational output for the instruction.

Flags Affected: OVER

Note the following:

1. The logical string for {cmd} is the same as the SUNAAMDX utility command line excluding the executable name.

2. Examples of the {ip} string are as follows:

 

127.0.0.1:3934

127.0.0.1

 

3. The OVER flag is set if the utility instruction encounters a failure. If the OVER flag is set, the S$ERROR$ variable contains the error code as defined in the PL/B Runtime Reference. If the OVER flag is cleared, the instruction executed successfully and the 'S00' data string is stored in the S$ERROR$ variable.

4. An internal Q option (-Q{logname}) allows the utility to append displayed data to a {logname} log file.

5. AAMDEX searches for operational keywords using the following sequence:

    the {inifile} if the '-I{inifile}' option is specified in the {cmd} string

    the default runtime INI file

    the User Environment Table (UET)

6. Refer to the SUNAAMDX topic in the PL/B Utilities Reference for command line specifications.

See Also: Example Code, Utility Instructions