Task: Local Date and Time

This task retrieves the local date and time based on the data in the city field.

Section 1: Short Answer

Transaction Name:

LocalDateTimeCT_6_0

Can any other transaction(s) perform this same task?

No.

Can this task be performed in a sessionless environment?

Yes.

Are the request and response identical on both the Apollo and Galileo systems?

Yes.

List any industry-specific knowledge required to understand this task in terms of the specific business process.

None.

Explain any special limits or distinct restrictions to the input data that may not be readily apparent.

The user must specify a city to receive date/time information. This transaction does not interrogate the requestor’s AAT to determine the user’s city code. In other words, this transaction replaces the @LTDEN terminal entry functionality. It does not replace the more generic terminal entry, @LT.

Section 2: Detailed Description

Request:

Unless otherwise specified, use ALL CAPS in any request data.

This is a simple stand alone request. Populate the city field then submit.

Prerequisite tasks:

There are no prerequisite tasks required.

Expected response:

The response consists of a single <LocalDateTime> tag (5301 v6.0) response. The <LocalDateTime> response contains the local date and time for the city specified in the request.

Error and warning responses:

There are no error fields in the <LocalDateTime> response. When an error situation is encountered, one of the following application error codes is returned in the header.

00 No error
01 Unrecoverable Host Error
02 Invalid Transaction
03 Invalid Major Version
04 Invalid Minor Version
05 Incomplete Data
06 Invalid City

When executing a terminal command, it is possible to send the request with no city code input to receive a default response. However, the XML request that is converted to structured data must contain a city code or else an error #06 (Invalid City) will be generated.

Following is an example of an error response:

<LocalDateTimeCT_6_0>
    <TransactionErrorCode>
        <Domain>AppErrorSeverityLevel</Domain>
        <Code>0001</Code>
    </TransactionErrorCode>
    <LocalDateTime>
        <ErrorCode>0006</ErrorCode>
    </LocalDateTime>
</LocalDateTimeCT_6_0>

Follow-on requests:

There are no follow on requests.

Section 3: Tables

Request (Input) Tags

<LocalDateTimeMods>

Terminal Equivalents:

Apollo

Galileo

Ordering	KLR	Min/Max	XML Tag
	5300	1-1	<LocalDateTimeMods>

Response (Output) Tags

<LocalDateTime>

Ordering	KLR	Min/Max	XML Tag
	5301	1-1	<LocalDateTime>

Related Samples

LocalDateTimeCT_6_0_1