artcicsutil is the premier control utility to track and dominate the CICS related resources from ART for Batch.

It is always triggered by ART for Batch jobs. With the single command, ART for Batch jobs can open/close files, enable/disable CICS transactions, initiate CICS transactions, and etc.

Currently, artcicsutil offers two kinds of sub commands set, IPCP and CAFC. Besides that, artcicsutil provides NATIVE mode, which can work as a native Oracle Tuxedo client without involving ART for Batch.

artcicsutil supports the following options:

-t command_mode

The mode of command set. Possible values are IPCPBTCH, CAFC, and NATIVE (default value).

• IPCPBTCH means artcicsutil accepts IPCP command set (artcicsutil acts as IPCP utility). The supported IPCP command set is listed as follows.
  • CICS CC ONLY=cics1[,cics2,...] (Choose the target ART for CICS region to process this request)
  • CLOS|CLOSE [DB] ddname1[,ddname2,ddname3,....] (Similar to SET FILE OPEN/CLOSE)
  • OPEN [DB] filea[,fileb,filec,filed,...]
  • DISA KC trna[,trnb,trnc,trnd,...] (Similar to SET TRANSACTION DISABLED)
  • ENAB KC trna[,trnb,trnc,trnd,...] (Similar to SET TRANSACTION ENABLED)
  • INIT KC trna[,data] (similar to START TRANSID)
• CAFC means artcicsutil accepts CAFC command set (artcicsutil acts as CAFC utility). The supported CAFC command set is listed as follows.
• c......c,STRT,xxxx,rrrr,ll,v....................................v (Similar to START TRANSID)
• NATIVE (default value) means artcicsutil accepts interactive commend set (artcicsutil acts as a native client, launched interactively by end users). The supported interactive command set is listed as follows. Those sub commands are full name or abbreviation, followed by appropriate arguments. Arguments in square brackets [] are optional. For enable/disable transid sub commands, you can set 18 transid items at most. For open/close VSAM file sub commands, you can set 18 file items at most.
  • applid (ap) [SSSSSSSS]: get/set applid
  • enable (ena) trna [trnb trnc ...]: enable transaction(s)
  • disable (dis) trna [trnb trnc ...]: disable transaction(s)
  • start (str) trna ['data']: start one transaction
  • open (op) FILE: open VSAM file
  • close (cs) FILE: close VSAM file
  • inquire (inq) FILE: inquire VSAM file
  • help (h) [command]: helps
  • quit (q): quit the tool

p profile

The name of the profile file used for authentication. This parameter is useful for secure Oracle Tuxedo configuration. The profile file must be created with genappprofile. If no file name is provided, it defaults to ~/.ADMINappProfile.

-d

This option enables diagnostic message output in IPCP or CAFC commend set.