Previous Topic: Customize the Supporting Resource Definition

Next Topic: Implementing Processes

Customizing the Environment That Manages Resources › Use Processes to Perform Complex Operations

Use Processes to Perform Complex Operations

A process is a series of steps that can be executed in sequence. Each step performs a single operation, by using a macro. The following sections describe how to use some of the macros to perform special operations.

For more information about other macros, see the online help.

Define a Process

To define a process

  1. Enter /RADMIN.P at the prompt.

    The Process List appears.

    Note: The process you create here is available to the specified system image only. To create a process that is available to all definitions in the knowledge base, enter /RADMIN.GP as the path.

  2. (Optional) Change the displayed system image. The last specified system image is the default system image.
  3. Press F4 (Add).

    The Process Definition panel appears.

  4. Complete the following fields:
    Name

    Specifies the name of the process (for example, SNMPTRAP).

    Description

    Describes your process.

  5. Complete the fields of the Process Steps window. For more information about the fields, press F1 (Help).
  6. Enter P beside each process step and specify the macro parameters.
  7. Press F3 (File).

    The system files the definition.

You can now specify the process in a resource definition for any action that requires more complex processing.

Check the Availability of a Destination CONNECT:Direct Node

Use the PINGCD macro to check the availability of a destination node for a CONNECT:Direct application. The return codes are as follows:

Return Code

Meaning

0

The destination node is available.

4

The destination node cannot be contacted.

8

The destination node is not defined in the network map of the CONNECT:Direct application. For example, you might have specified a wrong name.

By using the return codes, you can specify the next step to perform.

Specify the PINGCD Macro

To specify the PINGCD macro in your process

  1. Add or update a process for the macro.
  2. Complete the following fields on the Process Definition panel:
    Step Name

    Specify the process step.

    Macro

    Specify PINGCD as the name of the macro.

  3. Enter P beside your line entry.

    The PINGCD Macro Parameter Definition panel appears.

  4. Enter the PINGCD macro details. For more information about the fields, see the online help.
  5. Press F3 (OK).

    The Process Definition panel appears.

Issue CONNECT:Direct Commands from a Process

Use the CDAPI macro to issue a command to a specified CONNECT:Direct application. The macro monitors the response and sets a return code. By using the return code, you can specify the next step to perform.

Specify the CDAPI Macro

To specify the CDAPI macro in your process

  1. Add or update a process for the macro.
  2. Complete the following fields from the Process Definition panel:
    Step Name

    Specifies the process step.

    Macro

    Specifies the name of the macro. Enter CDAPI.

  3. Enter P beside your line entry.

    The CDAPI Macro Parameter Definition panel appears.

  4. Enter the CDAPI macro details. For more information about the fields, see the online help.
  5. Press F3 (OK).

    The system saves your changes and the Process Definition panel appears.

Use the SNMP Trap Exit

You can generate SNMP traps to inform a remote system of a resource state change.

The SNMPTRAP macro is supplied. To generate an SNMP trap, you define a process that uses this macro.

Create an SNMP Trap in a Process

To create an SNMP trap

  1. Add or update a process for the trap.
  2. Complete the following fields on the Process Definition panel:
    Step Name

    Specifies the process step.

    Macro

    Specifies the name of the macro. Enter SNMPTRAP.

  3. Enter P beside your line entry.

    The SNMPTRAP Macro Parameter Definition panel appears.

  4. Complete the following fields:
    Text

    Specifies the text to send with the trap.

    Destinations Dataset

    (Optional) Specifies the data set name (DSN) in which the addresses of remote systems is located

    Destination Address(es)

    (Optional) Specifies the destination addresses of the remote systems.

    Enterprise ID

    Specifies the format of the trap.

    Note: The format identified by this field is determined by your open platform administration

    Specific Trap Number

    Specifies the trap number.

    Community Name

    Specifies the community for which the trap is destined.

  5. Press F3 (OK).

    The system saves the details and the Process Definition panel appears.

Generate an Exception Report from a Process

The FTCHECK macro generates a file transfer exception report based on a specified filter. If a return code of 4 is received, more information is available in the returned variables, which can be checked further by the process to perform other actions.

For more information, see the online help.

Specify the FTCHECK Macro

To specify the FTCHECK macro in your process

  1. Add or update a process for the macro.
  2. Complete the following fields from the Process Definition panel.
    Step Name

    Specifies the process step.

    Macro

    Specifies the name of the macro. Enter FTCHECK.

  3. Enter P beside your line entry.

    The FTCHECK Macro Parameter Definition panel appears.

  4. Enter the FTCHECK macro details. For more information about the fields, press F1 (Help) to view the online help.
  5. Press F3 (OK).

    The settings are saved and the Process Definition panel appears.