Skip to main content

Run XP Job

What is it?​

run_xp_job.pl is the core script of the XP2 Connector. It grants OpCon the ability to start and monitor XP2 jobs running on an AIX platform.

  • Use this script for every XP2 job you want OpCon to schedule and track
  • Use the AutoReplyFile option when XP2 jobs prompt the console for input during execution
note

The configuration file for this script must be set up prior to running your first XP2 job. Refer to the Run XP Job INI file in the Reference section.

Command line​

To run XP2 jobs, create an OpCon job with a command line in the following format:

[[SMAXPSetup]] run_xp_job.pl <XP2 Job Name> <Arguments>
Example

To run the XP2 job called CONLIST:

[[SMAXPSetup]] run_xp_job.pl conlist

Tips and tricks​

  • If <arguments> contain double quotes, they must be escaped.
Example

The following argument contains double quotes:

spec=TRLMAIL,rnge-10-15-11*10-11-11,prm1=10-05-11,prm2=10-11-11,prm3=11,delm=",",file=lnmerge

The same argument line with the double quotes escaped:

spec=TRLMAIL,rnge-10-15-11*10-11-11,prm1=10-05-11,prm2=10-11-11,prm3=11,delm=\",\",file=lnmerge
  • The AutoReplyFile setting in the configuration file can be overridden on the command line.
Example

A command line where the AutoReplyFile is overridden:

[[SMAXPSetup]] run_xp_job.pl <XP2 Job Name> -AutoReplyFile=/ops/bin/AltAutoReplyFile.ini

FAQs​

Q: What if the XP2 job displays multiple console messages at different times?

A: Multiple responses for the same job name are permitted in the autoreply.ini file. See the Auto Reply File Format for details.

Q: What if an argument contains double quotes?

A: Escape each double quote with a backslash (\"). See the example in the Tips and tricks section above.

Q: Can I use a different autoreply file for a specific job?

A: Yes. Override the AutoReplyFile setting by passing -AutoReplyFile=<path> on the command line for that job.

Glossary​

AutoReplyFile — A configuration file that maps XP2 console prompts to automated responses. When an XP2 job displays a prompt on the console, the connector looks up the job name in this file and sends the configured reply automatically.

SMAXPSetup — An OpCon global property that stores the path to CreateXPEnvForPerl.ksh. Using this property in job command lines ensures the correct Perl environment is initialized before each script runs.