SWSINFO Built-in Function Runtime Values

This sample application is written in Shadow/REXX and is distributed in the NEON /*WWW ruleset. The output page is constructed dynamically by the Shadow/REXX rule, and illustrates the actual runtime values which can be interrogated using the SWSINFO() built-in function.

Note that the High-level-language API interface, SWCPGI, returns similar values for most requests, but returns binary codes in place of some of the character string values which are returned for REXX-language callers.

The current result and formatting column indicates how you use Shadow/REXX code to convert results into a displayable format. Normally, this involves converting a binary result to displayable hexadecimal.

 
SWSINFO Argument Description of Value Shadow/REXX Invocation Example
and Actual Runtime Value
ASID The two-byte, binary ASID for the current MVS address space.  

C2X( SWSINFO( 'ASID' ) )

 


  F0F1F8F4 (hex)

 

BYTES The count of data bytes within the current internal rule section element for this rule.  

SWSINFO( 'BYTES' )

 


  0 (decimal)

 

CLOCK The CPU Time-of-Day clock, in IBM STCK format, returned as an 8-byte binary value.  

C2X( SWSINFO( 'CLOCK' ) )

 


  DA7B38F77FABAF85 (hex)

 

CONNECTID A 4-byte, binary transaction/task identifier which is set to a unique value for every web transaction.  

C2X( SWSINFO( 'CONNECTID' ) )

 


  156CDDDD (hex)

 

CPUTIME The CPU time consumed so far, by this transaction, returned as an 8-byte binary value in IBM STCK format..

or, you can derive the decimal microseconds value as shown in the second example.

 

C2X( SWSINFO( 'CPUTIME' ) )

 


  000000000D74CF4D (hex)

 

 

C2D( X2C( SUBSTR( SWSINFO( 'CPUTIME', 6, 8 ) ) )

 


  55.116msecs (decimal)

 

CPUDELTA The CPU time consumed since the last CPUDELTA request was issued, or if no prior request has been made, the same value as for CPUTIME.

The CPU time value is returned as an 8-byte binary value in IBM STCK format.

Note: Compare the value reported in this table row, with the value returned in the very last table row.

or, you can derive the decimal microseconds value as shown in the second example.

 

C2X( SWSINFO( 'CPUDELTA' ) )

 


  000000000D76EB07 (hex)

 

 

C2D( X2C( SUBSTR( SWSINFO( 'CPUDELTA', 6, 8 ) ) )

 


  55.15msecs (decimal)

 

DB2PLAN The 8-byte DB2 plan name for which a thread is open/available for use by this MVS subtask. When thread reuse is enabled, this DB2 connection may be left over from a previous transaction procedure, and will be automatically closed if an incorrect PLAN, subsystem or userid association exists at the time of use.  

SWSINFO( 'DB2PLAN' )

 


  '' (NULL string)

 

DB2SUBSYS The 4-byte MVS subsystem identifier for the DB2 system for which a thread is open/available for use by this MVS subtask. When thread reuse is enabled, this DB2 connection may be left over from a previous transaction procedure, and will be automatically closed if an incorrect PLAN, subsystem or userid association exists at the time of use.  

SWSINFO( 'DB2SUBSYS' )

 


  '' (NULL string)

 

DOMAIN The character internet domain name for the client's internet connection, if known. If the domain name is not known, then a NULL string is returned.  

SWSINFO( 'DOMAIN' )

 


  '' (NULL string)

 

EVENTTYPE The type of event which has triggered execution of the rule which is currently running. The event type is returned as a 3-byte string.  

SWSINFO( 'EVENTTYPE' )

 


  WWW

 

HOSTDOMAIN The Server's internet Host domain name, if known, returned in character format. If the domain name is not known, then this request returns the character formatted IP address in dot notation format, (e.g. 148.24.78.70).  

SWSINFO( 'HOSTDOMAIN' )

 


  neonwebk.cmcf.state.il.us

 

HOSTNAME The Client's internet Host domain name, if known, returned in character format. If the domain name is not known, then this request returns the character formatted IP address in dot notation format, (e.g. 102.99.88.77).  

SWSINFO( 'HOSTNAME' )

 


  3.235.179.111

 

HTTPDOMAIN A character string containing the Server's internet HTTP domain name and port number. The string is formatted for use as a full-URL, protocol/domain/port, address, (e.g. "http://WWW.NEONSYS.COM:1080").

The port number is omitted, if the internet-wide default value, 80, is in use.

 

SWSINFO( 'HTTPDOMAIN' )

 


  http://neonwebk.cmcf.state.il.us

 

HTTPSDOMAIN A character string containing the Server's internet HTTP host domain name and port number. The string is formatted for use as a full-URL, protocol/domain/port, address, as for the HTTPDOMAIN value, but contains the information needed to establish an SSL connection with the server, (e.g. "https://WWW.NEONSYS.COM:1443").

If SSL support is not configured, this request returns the same value as HTTPDOMAIN. The port number is omitted, if the internet-wide default value, 443, is in use.

 

SWSINFO( 'HTTPSDOMAIN' )

 


  https://neonwebk.cmcf.state.il.us

 

IPADDRESS A character string containing the Client's internet IP address in dot notation format, (e.g. "22.104.32.37").  

SWSINFO( 'IPADDRESS' )

 


  3.235.179.111

 

LINKTYPE A string describing the communication link type to the client.  

SWSINFO( 'LINKTYPE' )

 


  OTC/IP

 

JOBNAME The MVS jobname for which this event and rule execution was triggered, returned as a 1-to-8 byte character string.  

SWSINFO( 'JOBNAME' )

 


  SWSK

 

PRODUCT A character string containing the name of the server product in which this rule is being executed.  

SWSINFO( 'PRODUCT' )

 


  SHADOW WEB SERVER

 

PRODUCTSTATUS A character string containing the status of the server product.  

SWSINFO( 'PRODUCTSTATUS' )

 


  ACTIVE

 

PROGRAM A character string containing the name of the currently executing program or rule.  

SWSINFO( 'PROGRAM' )

 


  NEON.INFOSAMP

 

ROWS A decimal value giving the number of rule source data lines which are coded for this section within the current rule definition.  

SWSINFO( 'ROWS' )

 


  463

 

SMFID The 4-byte SMF identifier for the current MVS system.  

SWSINFO( 'SMFID' )

 


  2283

 

SUBSYS The 4-byte MVS subsystem identifier for the server which is executing the current event and rule.  

SWSINFO( 'SUBSYS' )

 


  SWSK

 

SUBSYSASID The 2-byte, binary ASID address space identifier of the server product's main MVS address space.  

C2X( SWSINFO( 'SUBSYSASID' ) )

 


  F0F1F8F4 (hex)

 

TASKTYPE A character string describing the type of server processing subtask for which the current event and rule are being executed.  

SWSINFO( 'TASKTYPE' )

 


  REMOTE

 

TRANSTYPE A character string describing the type of transaction which is currently executing and for which the current event and rule are being executed.  

SWSINFO( 'TRANSTYPE' )

 


  WWW

 

USERID A character string containing the client userid if one was transmitted and value. If no client userid was transmitted, or the userid/password have not yet been validated, a NULL string is returned.  

SWSINFO( 'USERID' )

 


  '' (NULL string)

 

VERSION A character string containing the current version and release level of this server.  

SWSINFO( 'VERSION' )

 


  07.05.00

 

CPUDELTA This is the second of two CPUDELTA requests issued while building this page (see above). This request reports the CPU time consumed since the prior request was made.

or, you can derive the decimal microseconds value as shown in the second example.

 

C2X( SWSINFO( 'CPUDELTA' ) )

 


  0000000000138734 (hex)

 

 

C2D( X2C( SUBSTR( SWSINFO( 'CPUDELTA', 6, 8 ) ) )

 


  0.312msecs (decimal)