SERVICE_GET

The SERVICE_GET command allows JSM client applications to access the keyword / value properties from the properties file associated with the currently loaded service.

Client applications can access the value of properties associated with the service, but, perhaps more usefully, they can access application specific property values too, using the service properties file as a common medium for holding such values.

When used in the latter way, there is a possibility of conflict between application-defined keyword names and those used by current and future versions of LANSA Integrator. To reduce this possibility your application should prefix the property keyword with a global unique name. The examples below use com.acme.property as the prefix for this purpose.

The service property keyword value is returned in the JSM message field. If the keyword does not exist, then a status of NOT_EXIST is returned.

 

 SERVICE_GET -------- PROPERTY ----- value -------------------->

 

                  >-- TRACE ------- *PATH ---------------------|

                                    *SERVICE

                                    *TRANSPORT

 

Keywords

PROPERTY

Provide a keyword / value to be checked on the service properties file.

The service property keyword value is returned in the JSM message field. If the keyword does not exist in the service property file a status of NOT_EXIST is returned.

TRACE

  • *PATH – get trace folder path.
  • *SERVICE - read service trace file.
  • *TRANSPORT - read transport trace file.
  • Examples

    The examples retrieve the value of the com.acme.property.messagetype (an application-defined property) in the service properties file. This property might be defined in the service properties file with a line like this (the value "html" will be returned to the application in this case):

     

    com.acme.property.messagetype=html

     

    RDML

     

    USE BUILTIN(JSM_COMMAND) WITH_ARGS('SERVICE_GET PROPERTY(com.acme.property.messagetype)') TO_GET(#JSMSTS #JSMMSG)

     

    RDMLX

     

    #jsmcmd := ' service_get property(com.acme.property.messagetype)'

    use builtin(jsmx_command) with_args(#jsmhandle #jsmcmd) to_get(#jsmsts #jsmmsg)