Running commands using a MIMIX configuration element - assure_mimix - 10.0

Assure MIMIX Administrator Reference
Product type
Software
Portfolio
Integrate
Product family
Assure
Product
Assure MIMIX™ Software
Version
10.0
Language
English
Product name
Assure MIMIX
Title
Assure MIMIX Administrator Reference
Copyright
2024
First publish date
1999
Last edition
2024-08-27
Last publish date
2024-08-27T12:04:03.662993

To use RUNCMD or RUNCMDS using a MIMIX configuration element, do the following:

  1. From the MIMIX Main Menu, select option 13 (Utilities menu). The MIMIX Utilities Menu appears.

  2. From the MIMIX Utilities Menu, select option 1 (Select all commands). The Select Command display appears.

  3. Page down and do one of the following:

    • To run a single command on a remote system, type a 1 next to RUNCMD. The Run Command (RUNCMD) display appears.

    • To run multiple commands on a remote system, type a 1 next to RUNCMDS. The Run Commands (RUNCMDS) display appears.

  4. Specify the commands to run or messages to monitor for the command as follows:

    a.At the Command prompt specify the command to run on the remote system. When using the RUNCMDS command, you can specify up to 300 commands.

    b.If you are using the RUNCMDS command, you can specify as many as ten escape, notify, or status messages to be monitored for each command. Specify these at the Monitor for messages prompt.

  5. Specify the MIMIX configuration element using Table 79.

    MIMIX configuration protocols and specifications

    Protocol using

    MIMIX configuration element

    Protocol prompt value

    Also specify

    Run on system defined by the default transfer definition

    *SYSDFN

    System definition prompt:

    • Specify the name of the system definition or press F4 for a list of valid definitions.

    • Press Enter for additional prompts

    Run on the system specified in the transfer definition (TFRDFN parameter) that is not the local system

    *TFRDFN

    Transfer definition prompt:

    • Press F1 Help for assistance in specifying the three-part qualified name of the transfer definition.

    • Press Enter for additional prompts.

    Run on the system specified in the data group definition that is not the local system

    *DGDFN

    Data group definition prompt:

    • Press F1 Help for assistance in specifying the three-part qualified name of the data group definition.

    Run on the current source system defined for the data group

    *DGSRC

    Data group definition prompt:

    • Press F1 Help for assistance in specifying the three-part qualified name of the data group definition.

    Run on the current target system defined for the data group

    *DGTGT

    Data group definition prompt:

    • Press F1 Help for assistance in specifying the three-part qualified name of the data group definition.

    Run by the database apply process when the journal entry is processed

    *DGJRN

    Data group definition prompt:

    • Press F1 Help for assistance in specifying the three-part qualified name of the data group definition.

    Run on the system defined as System 1 for the data group

    *DGSYS1

    Data group definition prompt:

    • Press F1 Help for assistance in specifying the three-part qualified name of the data group definition.

    Run on the system defined as System 2 for the data group

    *DGSYS2

    Data group definition prompt:

    • Press F1 Help for assistance in specifying the three-part qualified name of the data group definition.

  6. Do one of the following:

    • To access additional options, skip to Step 7.

    • To run the commands or monitor for messages, press Enter.

  7. Press F10 (Additional parameters).

  8. At the Check syntax only prompt, specify whether to check the syntax of the command only. If *YES is specified, the syntax is checked but the command is not run.

  9. At the Local data area length prompt, specify the amount of the current local data area (LDA) to copy. This is useful for automating application processing that is dependent on the local data area and for passing binary information to command programs.

  10. At the Return LDA prompt, specify whether to return the contents of the local data area (LDA) from the remote system after the commands are run. The value specified in the Local data area length prompt in Step 9 determines how much data is returned.

  11. At the User prompt, specify the user profile to use when the command is run on the remote system.

  12. If you specified *DGJRN for the Protocol prompt, you will see the File prompts. Do the following:

    1. At the File name prompt, specify the name of the file to use when the journal entry generated by the commands is sent.

      Note: Use these prompts if you want the command to run in the database apply job associated with the named file. If a file is not specified, database apply (DBAPY) session A is selected.

      b.At the Library prompt, specify the name of the library associated with the file.

  13. If you specified a file name for the File prompt, you will see the When to run prompt. Using Table 80, specify when the journal entry associated with the command is processed by the target system for the specified data group.

  14. To run the commands or monitor for messages, press Enter.

Options for processing journal entries with MIMIX *DGJRN protocol

When to run

(Runopt)

Specify

Run when the database apply job for the specified file receives the journal entry

Do the following:

  1. At the Protocol prompt, specify *DGJRN.

  2. At the When to run prompt, specify *RCV.

Run in sequence with all other entries for the file.

Do the following:

  1. At the Protocol prompt, specify *DGJRN.

  2. At the When to run prompt, specify *APY.