4.3.3 Notes on the definitions of service linkage job information
- Organization of this subsection
(1) About definitions used for job execution
The service-linkage job definitions and authentication definitions defined in JP1/AJS3 for Cloud Service Applications are used by JP1/AJS3 as service linkage jobs in JP1/AJS3. Therefore, job execution of JP1/AJS3 may be affected if the definition of service linkage is updated or deleted.
Whether or not the job execution of JP1/AJS3 is affected is displayed on the Web screen of JP1/AJS3 for Cloud Service Applications as follows.
-
When updating or deleting the service linkage job definition or authentication definition used for a job that has once been executed, the message KNBB2407-Q or KNBB2408-Q is displayed in a dialog.
-
When editing each definition on the Web screen of the JP1/AJS3 for Cloud Service Applications, the upper part of the screen shows a message !Definition with job execution history.
Note that the period of time when such dialog or message is displayed depends on the value specified for USED_DEF_LIMIT in the environment setting file. For details on the environment setting file, see 3.4.1 Details of setting items of the environment setting file (ajs3csaweb.conf).
In addition, when creating new service-linkage job definitions or authentication definitions, if you perform registration by using a definition name that has previously been executed, even if the job has not executed even once, the aforementioned display processing is performed.
To check the details of a user's job in JP1/AJS3, use one of the following methods:
-
Check the unit name and host name of the job by referencing server job logs of JP1/AJS3 for Cloud Service Applications. For details about server job logs, see 8.2.3 Server Job Logs.
-
From the content of the unit definitions output by the ajsprint command or by JP1/AJS3 - Definition Assistant in JP1/AJS3, search for and check the service linkage jobs. For details about unit definition parameters, see 4.5 Unit definition parameters of service linkage jobs. For details about how to check the name of a service linkage job, see the description of the ajscsajoblist (Windows only) in 7. Commands.
(2) About definitions used in the service linkage job definitions
For service linkage job definitions, the connection definition and execution definition are specified to execute a job as the service linkage job. Therefore, job execution of JP1/AJS3 may be affected if the connection definition and execution definition are updated or deleted.
Whether or not the service linkage job definitions are affected is shown on the Web screen of JP1/AJS3 for Cloud Service Applications as follows.
-
When updating or deleting the connection definition or execution definition used for the service linkage job definitions, the message KNBB2409-Q or KNBB2410-Q is displayed in a dialog.
-
When editing each definition on the Web screen of the JP1/AJS3 for Cloud Service Applications, the upper part of the screen shows a message stating !Definition used for the service linkage job definitions.
(3) About handling of authentication information
Information that is registered with Protect specified in the authentication definitions is stored in the database file (AJSCSA.db) and backup file (AJSCSA.db.back) in the data directory in a non-plain-text, protected state.
No authentication information is output to a log file, nor the standard output or standard error output of a job.
Consider the notes below while taking into account the operations above when building an environment and designing security measures.
-
Communication is performed by using protected non-plain-text information. However, authentication information is included in communication data. For this reason, we recommend that you build an SSL communication environment, unless your environment has no security risks, such as the risk of data being read on the communication path.
-
JP1/AJS3 for Cloud Service Applications does not output protected authentication information to the standard output, standard error output, and logs, but may output authentication information to the command line used for definition. Before specifying definitions, check and verify the specifications of the command lines to be used.
(4) Other notes
-
To check with the changed service linkage job information about whether the job has been executed, take either of the following methods.
-
Open the service linkage job log file on the job execution host, and check if the command line with changed details has been output on the CLI.
-
When details have been changed in the standard error output or standard output of the service linkage job, check the execution result details check screen of JP1/AJS3 - View or the data in the standard output file.
-