Syntax for cicsping

Following is the syntax for the cicsping utility and details about each cicsping parameter. Parameters enclosed in square brackets are optional. The default is the -Rregion_file for the specific platform.

cicsping [-Hhostname -Nportnumber]
 	    	    [-Thost_tramsaction_id] 
 	    	    [-Rregion_file
	    	    [-Uuser_name [-Ppassword]]][-v]

Table B-1 lists each parameter, the operating system for which it is valid, and a description of the parameter.

**Table B-1: *cicsping* parameters**
Parameter	Valid operating system	Description
-Hhostname	HP-UX HP Itanium IBM RISC System/6000 Sun Solaris	The name of the mainframe as defined in your NIS map or your /etc/hosts file. This is the same name you use in the hostname property of the exec sgw_addregion command of the Transaction Router Service or the ConnectionSpec1 value of a DB2 access service (see the Mainframe Connect DirectConnect for z/OS Option Users Guide for Transaction Router Services for more information). When you use the -H parameter, you must also use the -N parameter.
-Hhostname	Windows	The name of the mainframe as defined in your Domain Name Server (DNS) or your %windr%\system32\drivers\etc\hosts file. This is the same name you use in the hostname property of the exec sgw_addregion command of the Transaction Router Service or the ConnectionSpec1 value of a DB2 access service (see the Mainframe Connect DirectConnect for z/OS Option Users Guide for Transaction Router Services for more information). When you use the -H parameter, you must also use the -N parameter.
-Nportnumber	All	The number of the mainframe port where the CSKL (TCP/IP Listener) transaction listens. This is the same number you use in the portnumber property of the exec sgw_addregion command of the Transaction Router Service, or the ConnectionSpec2 value of a DB2 access service (see the DirectConnect for z/OS Option Transaction Router Service Users Guide for more information). When you use the -N parameter, you must also use the -H parameter.
-Rregion_file (This parameter has no application to the DB2 Access Service Library.)	HP-UX HP Itanium RISC/6000 Sun Solaris	The name of the TRS connection file. The default is $SYBASE/$DSQUERY.reg. You can use this parameter if you are running cicsping after you configure TRS. TRS example files: $SYBASE/$SYBASE_ECON/server_name/cfg/ngreg.trstcp. When you run cicsping before you configure TRS, omit this parameter and use the -H and -N parameters.
	Windows	The name of the TRS connection file. The default is %SYBASE%\%DSQUERY%.reg. You can use this parameter if you are running cicsping after you configure TRS. TRS example files: %SYBASE%\$%SYBASE_ECON%\server_name\cfg\trstcp.ngreg. When you run cicsping before you configure TRS, omit this parameter and use the -H and -N parameters.
-Uuser_name	All	The mainframe user ID of the client issuing the command. It must be in uppercase.
-Ppassword	All	The mainframe password of the client issuing the command. You must use the -U parameter to use the -P parameter. It must be in uppercase.
-Thost_transaction_id	All	The name of the z/OS mainframe (host) transaction called by cicsping that runs the cicsping program SYGWCAI2. This program is required for cicsping to execute successfully. The default transaction, SYPG, is called if you run cicsping without the -T parameter and value. Use the -T parameter if the cicsping transaction has a name other than SYPG. The value of this parameter must be in uppercase.
-v	All	Use this parameter to display information about the current version of cicsping. When it executes with the -v parameter, cicsping does not run.