Selects batch input sessions and lists the result in the activation reportA report provides more detailed information about a task's execution or a component. or a file.
Transaction: SM35
Interface: AE
R3_GET_SESSIONS
NAME=...
CREDATE_FROM=...
CREDATE_TO=...
STATUS=...
[,FILE=...]
[,NOFOUND=...]
[,ORDER_BY=...]
Syntax |
Description/Format |
---|---|
NAME= |
Selection of batch input sessions by name. The wildcard charactersThese are placeholders for characters when you specify filters. ? stands for exactly one character, * for any number of characters. "*" and "?" can be used. "*" stands for any character, "?" for exactly one. |
CREDATE_FROM= |
Selection of batch input sessions by their
date of creation (Start date of the selection). |
CREDATE_TO= |
Selection of batch input sessions by their
date of creation (End date of the selection). |
STATUS= |
Selection of batch input sessions by their
statusThis represents the condition of a task (such as active, blocked, generating).. Allowed values: " " (default value), "R", "F" and "E" " " - Batch input sessions that are still to be processed. |
FILE= |
Name of a file to which the selection results
(found batch input session) should be written. This parameter can be used to write the result to a specified file (not to the activation report). There is a line for each located batch input session. The first 13 positions contain the names of the sessions and the additional 21 positions the queueA particular Automation Engine (AE) object type. In AE, a queue determines the maximum number of concurrent tasks, their priorities and the order in which tasks should be executed. In ARA, queues are containers for workflow executions that should be executed at a certain time one after another. ID. |
NOFOUND= |
Handling if the batch input sessions have not been found. Allowed values: "NORMAL" (default value) and "ABEND" "NORMAL" - The script continues,
the AE jobAn Automation Engine object type for a process that runs on a target system. ends normally. |
ORDER_BY= |
Criterion according to which selected sessions are sorted. All field names of the SAP table APQI can be used. For example: ORDER_BY=GROUPID This parameter is available for SAP versionsAn application version holds zero or more deployment packages and may have dependencies to zero or more application versions of the same (or to different) applications 4.6 and later. |
ENCODING= |
Encoding for the generated output file (Parameter FILE=). For example: UTF-8 Default value: ISO-8859-1 When you specify an encoding that is not supported or invalid, the job will abort with an error message. The SAP Forms provide an input assistant for this field which lists all the supported encodings. |
The result of the selection is either written to an activation report or to a file. There is a line for each located SAP job. Structures of the lines in the activation report differ from those in the file.
Columns are used in the file. The first line of the file contains information about the size and content of the columns. The individual lines are divided according to these specifications. The first 13 positions contain the name of the respective batch input session, the next 21 contain the queue ID - and in the last 13, the creator of the batch input session (userIn the Automation Engine, a user is an instance of a User object, and generally the user is a specific person who works with Automic products. The User object is assigned a user ID and then a set of access rights to various parts of the Automation Engine system and product suite. These access rights come in the form of Automation Engine authorizations and privileges, Decision user roles and EventBase rights and ARA web application object rights. You can manage all these centrally in the ECC user management functions. See also, Unified user management.) is output.
The parameter ORDER_BY can be used to sort the selected batch input sessions according to particular criteria.
In the activation report, the information within a line is separated with a semicolon. Additionally, a time stamp and AE Message number are output at the beginning of the line.
The result of the selection can be analyzed using script functions. In the Post Process tab, PREP_PROCESS_REPORT can be used to analyze the activation report. PREP_PROCESS_FILE can be used when the selection result was saved in a file.
With Automation EngineThis component drives an Automation Engine system and consists of different types of server processes. version 2.63E, the creator of the batch input session is also output at the end of each line in the activation report or file. This can sometimes cause problems in existing AE Scripts when the data sequenceAn internal listing of Console outputs or lines of Variable objects, etc. The lines of a data sequence can be accessed by using a PROCESS loop or the script element GET_PROCESS_LINE. The script elements PREP_PROCESS* generate data sequences. created with PREP_PROCESS_* is not divided into columns. This can be when the entire line is processed with string functions.
Note that by default, created files are stored on the computer on which the agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host has been installed (for example, R3_GET_JOB_SPOOL; FILE=).
The first example selects all batch input sessions that should be processed today and show the name "NI".
:SET &TODAY# = SYS_DATE(YYYYMMDD)
R3_GET_SESSIONS NAME='NI',CREDATE_FROM='&TODAY#',CREDATE_TO='&TODAY#',STATUS="
"
In the activation report, lines similar to those shown below are output:
20020313/135601.000 - U2004943 ;AE_TEST;20020312NI;NI
The second example selects all batch input sessions between 1/1/2000 and 1/1/2002 that resulted in errors while they have been processed. The result of the selection is saved in a file.
R3_GET_SESSIONS NAME='*',CREDATE_FROM='20000101',CREDATE_TO='20020101',STATUS='E',FILE='sessions.txt'
The first lines in the file can look as follows:
COL=LENGTH,LENGTH_TAB='13=GROUPID,21=QID,13=CREATOR'
AE_TEST 20020314095728031322
NI
AE_TEST 20020314095823023148
NI
AE_TEST 20020314100932031323
NI
See also:
Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support |
Copyright © 2016 Automic Software GmbH |