Professional Documents
Culture Documents
GCS Verification System Operation Manual
GCS Verification System Operation Manual
Global
Operation Manual Function Name Material Master Verification Notes Y/N
4. Background Job
4-1. Define Background Job …………………………….……………… Page 58
- Define background job
- Define conditions of background job
- Create step of background job
4-2. Confirm Job log and Spool ………………………………………… Page 61
- Select the relevant job
- Job overview
- Output controller : List of spool requests
- Graphical display of spool requests
2nd Edition 05.Nov.2003 Page 21. Modified Incorrect descriptions of Ext. Command Name
Page 33. Added additional information for Destination directory.
Page 41. Added additional information for Destination directory.
3rd Edition 04.Feb.2004~ Added 2nd Phase Development Requirements
1. Introduction
1-1. Overview – System Overview
Application
data
1) Global Code registration
GIS Server
GCS
Original
MQ GCS Copy DB
for distribution G-cat
D-cat
G-cat
D-cat
Report Check
result file
1. Introduction
1-1. Premises of system operation (Batch Process)
- From R/3 side point of view, the batch process consists of “Material extraction” and “Material
synchronization”.
- These 2 processes must be scheduled including GCS verification function (for batch) between them. Here is
a restriction - They must be scheduled in the same day – because the intermediate files used to transfer
their parameters and return values include the process date in their file names, and if these 2 batch
processes are executed on different days, whole batch process will not work properly.
Check
result file
1. Introduction
1-2. Process Flow
GCS
Verification
Function
2-1. Material Online Entry Check (Online)
Batch process
Extracte
d
Material GCS
code Verification
2-2. Material Extraction
Function
Control (Batch)
file
Check
result file
1. Introduction
- “hosts” file
controls the
relationship
between computer
name and actual IP
address.
Result
1. Introduction
Result
- Server’s name in “.rhosts” must not be an IP address but a computer name. Therefore the
server name must be properly registered in “hosts” file before this setting.
1. Introduction
[Permission]
/in/ [Input files] 775(rwxrwxr-x)*
… Files created at execution
[Permission]
/out/ [Output files] 775(rwxrwxr-x)*
… Files created at execution
[Permission]
/log/ [Log files]
775(rwxrwxr-x)*
… Files created at execution
[Permission]
/src/ [Source files] 775(rwxrwxr-x)*
model_veri_func.c
model_veri_rept.c
model_veri.h Not specified
comfunc.c
comfunc.h
comsql.pc
comsql.h
makefile * Descriptions written
with italic font are
permissions for folders.
Result
Remarks - Make sure to set relevant permission for each directory as well as file.
1. Introduction
- GCS verification
system modules
have environment
files. Here how to
configure the
environment file for
online is explained. Value : Case sensitivity on.
Make sure to spell correctly.
Result
Remarks -In [UID] [PWD] entry, actual user id / password value must be filled.
-All entries are mandatory.
1. Introduction
- GCS verification
system modules Value : Case sensitivity on.
have environment Make sure to spell correctly.
files. Here how to
configure the
environment file for
batch is explained.
Output & Error Directory :
Be sure to enter the same value.
Otherwise, subsequent process
(R/3 synchronization) cannot work
correctly.
No Item Explanation
1 SID Enter “gcmprod” (Oracle SID).
2 UID Enter Oracle user name.
3 PWD Enter password for the Oracle user.
Enter log file name. (e.g.”../log/model_veri_func.log”)
4 LOG
Process log will be output in this file.
Result
Remarks -Make sure to set the same directory for entries [OTD] (Output files directory) and [ERD]
(Error files directory).
-In [UID] [PWD] entry, actual user id / password value must be filled.
-All entries are mandatory.
1. Introduction
[Permission]
/out/<Client No>/ [Output files] 775(rwxrwxr-x)*
e.g. /out/210 … Files created at execution
* Descriptions
written with
italic font are
permissions for
folders.
Result
Remarks - Make sure to set relevant permission for each directory as well as file.
1. Introduction
- RFC destination
determines
interface between
R/3 and external
modules that are to
be called via RFC.
- RFC destination
can be edited on
transaction “SM59”.
Select connection
type
Procedure 1) Log onto R/3, and open RFC destination setting screen with transaction code [SM59].
2) Click on “TCP/IP Connections”.
Result
Remarks - A RFC dest. “SAPFTPA” is necessary for this system. Although this RFC dest. Is
created by SAP, it might not exist due to any R/3 install options. Therefore we must
check if RFC dest. “SAPFTPA” exists or not at first. If exists, you can use it and skip this
RFC dest. setting procedure.
Otherwise, you must define an additional RFC dest. instead of “SAPFTPA”, following to
the steps explained from the next page.
1. Introduction
Result
Remarks - You can check / edit the details of RFC destination setting by clicking on [Change] button,
putting cursor on the target RFC dest.
1. Introduction
Program to
execute
Result
Remarks - It is recommended to check if this RFC dest. setting can actually connect to the destination
system, by clicking on [Test connection] button, before saving.
1. Introduction
Procedure 1) Log onto R/3, and open “External operation system commands” screen with transaction
code
[SM69].
2) Click on [Display <> Change] button, and the screen goes on to maintenance mode
(The table of external commands will be striped then).
3) Click on [Create] button.
Result Goes to Initial setup of External Operating System Commands (2) (1-4-6 Page 15).
Remarks
1. Introduction
Program to execute
Result Goes to Initial setup of External Operating System Commands (1) (1-4-5 Page 14).
Remarks
1. Introduction
- “hosts” file
controls the
relationship
between computer
name and actual IP
address.
Machine name
IP Address
Result
1. Introduction
Procedure 1) Log onto R/3 and launch SAP IMG reference menu [SPRO].
2) Access menu by : Logistics - General >> Material Master >> Field Selection >>
Maintain Field Selection for Data Screens
3) Enter field selection group and enable following items to be entered, as follows:
(Field setting group) : (Option to be selected)
125 (Field setting group including [DG indicator profile]) => [Opt. entry]
151 (Field setting group including [Ext matl group]) => [Opt. entry]
155 (Field setting group including [Valid From] and [X-Plant matl status]) => [Opt.
entry]
1. Introduction
- [DG indicator
profile] is used as
“Global flag” in this
system. This “flag”
means either of
“Local” “Global” or
“Pending”, the
status of the An entry to be modified (desc.)
material.
- As this usage is
An entry to be added
different from R/3
default, some items
must be modified
and added in
advance.
Procedure 1) Log onto R/3 and launch SAP IMG reference menu [SPRO].
2) Access menu by : Environment, Health & Safety >> Dangerous Goods management >>
General Basic Settings >> Define Indicator Profile for the Material Master [OMS9]
3) Modify & enter field values as follows :
(Pro.) : (Description of DG Profile)
001 => (Modify) [Global Material]
002 => (Add) [Pending]
003 => (Add) [Discontinued] Out of date
004 => (Add) [No G-Cat/D-Cat]
Remarks - Checkboxes “DG” “Chk” and “Pap”, they have no effect on the GCS verification function.
1. Introduction
- [External Material
Groups] is used as
“D-Cat & G-Cat” in
this system.
- As this usage is
different from R/3
default, some items An entry to be modified (desc.)
must be modified
and added in
advance.
An entry to be added
Procedure 1) Log onto R/3 and launch SAP IMG reference menu [SPRO].
2) Access menu by : Logistics - General >> Material Master >> Settings for Key Fields >>
Maintain External Material Groups
3) Modify & enter field values(8digits) for G-CAT(3digits) & D-CAT(5digits)
[For example]
(Ext. material group) : (Ext. matl grp descr.)
11122222 XXXXXXXXXXXXXXX
This configuration is not necessary
After implementation of
The new value and entry is enabled to be selected in MM01.
Result
2nd phase development,
Remarks Because “Ext matl group” is
not used.
1. Introduction
- [Product
Hierarchy] is used
as “D-Cat & G-Cat”
in this system.
- All combinations of
G-CAT and D-CAT
must be registered An entry to be modified (desc.)
with this screen, in
advance.
Click on this button to add a
new entry
Procedure 1) Log onto R/3 and launch SAP IMG reference menu [SPRO].
2) Access menu by : Logistics - General >> Material Master >> Settings for Key Fields >> Data
Relevant to Sales and Distribution >> Define Product Hierarchies
3) Choose [Product Hierarchies].
4) Modify & enter field values(8digits) for G-CAT(3digits) & D-CAT(5digits)
[For example]
(Prod. Hierarchy) : (Prod. Hierarchy Description.)
11122222 XXXXXXXXXXXXXXX
Result The new value and entry is enabled to be selected / entered in MM01.
Remarks
Procedure 1) Log onto R/3 and launch ABAP editor (Transaction code=“SE38”).
2) Enter the program name “Y0_MM_SAR0001” in the field [Program], and execute it by
clicking [Execute] button.
Remarks
1
2
3
4
5
Result Goes to 3rd setup screen for Variant (2-1-3 Page 22).
Remarks
[Create] button
Procedure 1) Log onto R/3 and launch transaction maintenance screen (Transaction code = “SE93”).
2) Enter the name of transaction (Here, “y0_mm_0001” is recommended).
3) Click on [Create] button.
- To avoid registering new materials without GCS copy DB verification, please make sure to
use the transaction defined here, when end-users register new materials. (That is, please do
not call SAP standard material registration screen by entering transaction code “MM01”).
[Continue] button
No Item Explanation
1 Transaction text Enter explanation for the transaction.
2 Program Enter “y0_mm_sar0001”.
3 Selection screen Please do not edit here.
5th screen
[Continue] button.
Procedure 1) Enter the development class name “y0_mm_s0001” in the field [Development class].
2) Click on [Save] button, and then navigates to the 5th screen.
3) Enter proper request# in the field [Request].
4) Click on [Continue] button.
Material descriptions
G-CAT / D-CAT
Global Flag
4) Click on “Change”.
Result Goes to 2nd setup screen for Variant (2-2-2 Page ).
Remarks
4) Click on “Create”.
Remarks
Remarks
7
8
9
10
11
Remarks
No Item Explanation
Enter Division Code up to 8 digits (Ex. 00012345)
1 Division Code (*) Entered Division code is set into the file name. (Ex. S00012345-20030917-
01.dat)
2 Material Code Enter Material Code when you want to extract specified Material code.
Enter Process date in date format.
3 Process Date (*) Entered Process Date is set into the file name. (Ex. S00012345-20030917-
01.dat)
Check this flag when you want to extract Global & Pending Material code except Local
Global Flag Material code from R/3 Material master.
4 Sync local Check this flag when you extract global & discontinued Out of date materials.
Registered Material Uncheck this flag when you extract local & pending & no G-cat/D-cat materials.
When you execute Material extraction process for plural times a process date,
5 Request No. (*) please enter sequential number into Request No.
Entered Request No. is set into the file name. (Ex. S00012345-20030917-01.dat)
7 Host (*) Enter Host information for FTP process. (Ex. 123.456.789)
8 User (*) Enter FTP User name.
9 Password (*) Enter FTP User password.
Enter Destination Directory.
After FTP process, file is created in this directory.
10 Destination Directory (*)
This directory name should be same as Input directory (‘IND’) described in GCS
verification function ENV file (model_veri_rept.env). See below [Fig.1].
Default “SAPFTPA”.
11 RFC Destination (*)
This is for RFC function. It is not necessary to change this value.
[Fig.1] Environmental setting file of GCS verification function (model_veri_rept.env)
Procedure No Explanation
1 Main process starts.
[Material Extraction process]
Material are extracted from R/3 Material master matching the criteria specified.
2 You can confirm following points.
- Description according to the status of checkbox.
- How many Material are extracted.
[File Creation process]
3 After extraction process, 2 files (Material data file, Control file) are created in R/3 server.
You can confirm the file name and path.
[FTP process for Material data file]
4 File is transferred from R/3 server to destination server.
You can confirm FTP information.
Result .
Remarks
Procedure No Explanation
[FTP rename process for Material data file]
5 File is renamed after FTP process.
You can confirm renamed file name.
Result
Remarks
Procedure No Explanation
[FTP rename process for Control file]
7 File is renamed after FTP process.
You can confirm renamed file name.
Result
Remarks
4) Click on “Change”.
Result Goes to 2nd setup screen for Variant (2-3-2 Page ).
Remarks
4) Click on “Create”.
Remarks
Remarks
7
8
9
10
11
Remarks
No Item Explanation
Enter Division Code up to 8 digits (Ex. 00012345)
1 Division Code (*) Entered Division code is set into the file name. (Ex. S00012345-20030917-
01.dat)
Enter Process date in date format.
2 Process Date (*) Entered Process Date is set into the file name. (Ex. S00012345-20030917-
01.dat)
When you execute Material Synchronization process for plural times a process
3 Request No. (*) date, please enter sequential number into Request No.
Entered Request No. is set into the file name. (Ex. S00012345-20030917-01.dat)
7 Host (*) Enter Host information for FTP process. (Ex. 192.168.0.5)
8 User (*) Enter FTP User name.
9 Password (*) Enter FTP User password.
Enter Destination Directory.
After FTP process, file is created in this directory.
10 Destination Directory (*)
This directory name should be same as Output directory (‘OTD’) described in
GCS verification function ENV file (model_veri_rept.env). See below [Fig.1].
Default “SAPFTPA”.
11 RFC Destination (*)
This is for RFC function. It is not necessary to change this value.
Procedure No Explanation
1 Main process starts.
[FTP process for Error control file]
2 File is transferred from destination server to R/3 server.
You can confirm FTP information. (refer to Note for FTP messages of next page)
Result
Remarks
Procedure No Explanation
[FTP process for Check result file]
3 File is transferred from destination server to R/3 server.
You can confirm FTP information. (refer to Note for FTP messages of next page)
6
7
Procedure No Explanation
[File loading process]
4 The control file and the check result file is loaded.
You can confirm the file name and path.
[List of the Material which updates by the next Batch Input processing]
5 You can confirm following values.
1. Material No. / 2. Update field / 3. old and new value
Result
Remarks
3. Message Guide
3-1. Overview
3-1 Overview
Message type
This table describes the types of messages the batch programs issue.
Message Type Function
Indicates that the batch program can't process the file.
Error
Process is interrupted.
Explanation
Possible reasons for the error or warning or a detailed discussion of the type of information the message presents.
Procedure
The procedure or response you must follow or give to continue processing.
Message Sample
[Information Message]
3. Message Guide
No Explanation
900 Database system error occurred. Call Administrator: [< >]
Message type: Warning
Explanation:
Error occurred in the database of GCS Verification server.
Procedure:
Please call Administrator.
3. Message Guide
Procedure:
Fill all mandatory fields (Material No., Industry Sector, Material Type) properly and try again.
Y0_MM_0001 000 Failed to call external function. Call Administrator: [< >]
Message type: Error
Explanation:
Failed to call GCS verification function. The program terminates immediately after
displaying this message.
Procedure:
Please call administrator.
Y0_MM_0001 002 Material & code has expired. Register anyway ?: [< >]
2004.02.12 mod
Message type: Warning
Explanation:
Material code you entered exists in GCS copy DB, but is out of date.
It means that the material is “discontinued” was regarded as “Global” at one time.
However, it is no longer available for use in the GCS system.
Procedure:
If you still allow the material to be registered, press [YES].
If you do not allow, press [NO].
Procedure:
If you still allow the material to be registered, press [YES].
If you do not allow, press [NO].
3. Message Guide
3. Message Guide
Procedure:
If you still allow the material to be registered, press [YES].
If you do not allow, press [NO].
Y0_MM_0001 018 Parameter error occurred in GCS veri func. Register anyway as local code?: [< >]
Message type: Warning
Explanation:
Invalid parameter is returned from GCS verification function.
If you still need to proceed, you can only register it as a local code.
Procedure:
If you still allow the material to be registered, press [YES].
If you do not allow, press [NO].
Y0_MM_0001 019 GCS func has returned a unexpected err[ & ]. Register anyway as local cd?: [< >]
Message type: Warning
Explanation:
System encountered some exceptional error(s) while calling GCS verification function.
If you still need to proceed, you can only register it as a local code.
Procedure:
If you still allow the material to be registered, press [YES].
If you do not allow, press [NO].
3. Message Guide
Procedure:
Please specify the correct path.
Execute material extraction process again.
Y0_XX_0001 006 Cannot write file. Filename : [<File Name>]
Message type: Error
Explanation:
System cannot write data into the target file.
Procedure:
Please check the specified file.
Execute material extraction process again.
Y0_XX_0001 008 Data not found. Tablename : [<Table Name>]
Message type: Error
Explanation:
The target data does not exist in R/3 Material master.
Procedure:
Please change the search condition.
Execute material extraction process again.
Y0_XX_0001 043 Error occurred in FTP process.
Message type: Error
Explanation:
FTP process ends with error.
Procedure:
Please check FTP connect information.
Execute material extraction process again.
3. Message Guide
Procedure:
Please check FTP connect information.
Execute material extraction process again.
Procedure:
Procedure:
Procedure:
3. Message Guide
Procedure:
Y0_XX_0001 712 MAIN PGM: [<Process Name>] Process abnormal end.
Message type: Error / Information
Explanation:
Material extraction process ends abnormally.
Procedure:
Please take measures against the error.
Execute material extraction process again.
Procedure:
Y0_XX_0001 714 SUB PROCESS: [<Process Name>] Process normal end.
Procedure:
3. Message Guide
Procedure
Please take measures against the error.
Execute material extraction process again.
Procedure:
Y0_XX_0001 717 File renamed from [<File Name1>] to [<File Name2>] successfully.
Procedure:
3. Message Guide
Procedure:
Y0_MM_0001 008 Global/Out of Date material codes are extracted from R/3 master.
Message type: Information
Explanation:
When you set “Sync Local Registered Material Only” unchecked,
global / discontinued Out of date material codes are extracted from R/3 material master.
Procedure:
3. Message Guide
Procedure:
Please specify the correct path.
Execute material synchronization process again.
Y0_XX_0001 043 Error occurred in FTP process. : [<FTP Process Name>]
Message type: Information
Explanation: FTP process ends with error.
<FTP Process Name>
FTP connection error : Do not connection to FTP server(GCS server).
FTP command error : Error occurred when FTP command was executed.
TCP/IP error : Error occurred when FTP command was executed.
Normal FTP ECHO was not returned. : Transfer of the target file was failed.
Procedure:
Please check FTP connect information.
Execute Material synchronization again.
3. Message Guide
Procedure:
Y0_XX_0001 708 FTP Host: [<FTP Host>] /FTP User: [<FTP User>]
Message type: Information
Explanation:
Displays FTP destination and FTP user to which the system is logging on.
(The value typed in the initial screen)
Procedure:
Procedure:
3. Message Guide
Procedure:
Y0_XX_0001 712 MAIN PGM: [<Process Name>] Process abnormal end.
Message type: Error / Information
Explanation:
Material synchronization process ends abnormally.
Procedure:
Please take measure against the error.
Execute material synchronization process again.
Procedure:
Y0_XX_0001 714 SUB PROCESS: [<Process Name>] Process normal end.
Procedure:
3. Message Guide
Procedure
Please take measures against the error.
Execute material synchronization process again.
Y0_XX_0001 901 Unexpected system error occurred. Call Administrator: [< >] .
Message type: Error / Information
Explanation:
Unexpected system error has occurred in GCS verification function.
Material synchronization process ends abnormally.
Procedure:
Call system administrator and ask him to take measures against the error.
Execute material synchronization process again.
3. Message Guide
Procedure:
Please take measures against the error.
Execute material synchronization process again.
Y0_MM_0001 004 GCS error message code : [< error code >]
Message type: Error
Explanation: The error number is notified in the error control file.
Procedure:
Please take measures against the error.
Execute material synchronization process again.
Y0_MM_0001 009 Record count is different.
Result file: [<Record Count>] Control file: [<Record Count>]
Message type: Error
Explanation: There is a discrepancy between the check result file record count and
“record count” value contained in the control file.
Procedure:
Call system administrator and ask him to take measures against the error.
Execute material synchronization again.
3. Message Guide
Procedure:
Please call system administrator and ask him to take measures against the error.
Execute Material Synchronization again.
Procedure:
Y0_MM_0001 012 Update Material No: [<Material Code>] / Field: [<Update Field>] =
([<Old Value>] ) -> ([<New Value>] ).
Message type: Information
Explanation:
This material code will be processed with batch-input (R/3 standard data updating method).
** Note that all the materials shown here might NOT exactly correspond to the materials
updated, because of some irregular cases, such as master data inconsistency etc.
Make sure to check updating status with SM35, batch-input session manager.
Procedure:
Y0_MM_0001 013 GCS fnc has returned a error cd([<Material Code>]) against
material([<Material Code>]). Call admin.
Message type: Error (but process continues after this message.)
Explanation:
GCS verification function has returned a error code against the material specified.
(Message type is “Information" in order to process remaining materials, regardless whether
the system detects errors in synchronization process or not.)
Procedure:
Call system administrator and ask him to take measures against the GCS error.
Execute material synchronization process again.
Date Care Of Approved by Created 17.Sep.2003 Document No.
17.Sep.2003 Checked
om-01-01 05.Nov.2003 Approved Page 57
Operation Manual 01.Mar.2004
12/06/21 11:09 AM
GCS Verification System System Name GCS Verification System Region Name Y0.Global
Operation Manual Function Name Material Master Verification Notes Y/N
3. Message Guide
No No Explanation
Y0_MM_0001 015 Total count of update Material: [<Record Count>]
Message type: Information
Explanation:
Information of the materials which will be updated with batch-input processing.
Procedure:
Y0_MM_0001 016 GCS copy DB function has returned a fatal error code.
Message type: Error(When online execution) / Information(When back ground execution)
Explanation:
The system detected a fatal error code (parameters, database and other unexpected errors)
in the result file from GCS verification function.
Procedure:
Call system administrator and ask him to take measures against the error.
Execute material synchronization process again.
Explanation:
Past date is not permitted to populated in “Process Date” field of selection screen.
Procedure:
Y0_MM_0001 025 Get the check result file.
Message type: Information
Explanation:
The system is getting the check result file from GCS server via FTP.
(This is synchronization Process step message.)
Procedure:
3. Message Guide
4. Background Job
Procedure 1) Type in the items ‘1’. Then click on the “Start condition” and “Step”. End up with click on the “Save”.
No Item Explanation
Enter a name or short description to identify your job. The
1 Job name name can include any typable character, including spaces.
Example: “z_jobtest_for_material_check"
Enter one of the following classes for your job:
•A: Jobs with high priority whose execution is absolutely
necessary for further processing.
Class A jobs are always processed before jobs of other classes.
1 Job class •B: Jobs that should be run at regular intervals, for example,
jobs transferring performance statistics.
Class B jobs are processed before class C jobs.
•C: Jobs that neither fit into class A nor in class B and that
do not require a higher priority. Class C is the default class.
2 Start condition Goes to “Start Time” Screen (4-1-2 Page).
3 Step Goes to “Create step” Screen (4-1-3 Page).
4 Save Releases the job.
If you click on the “Save” button, you can release this job.
Result
4. Background Job
3 7
4
4. Background Job
2
3
2 ABAP program Name Type in the program name which executes by job.
Remarks
4. Background Job
Access menu by :
SAP Easy Access
-> System -> Jobs
-> Job overview
Procedure 1) Type in the items ‘1’ and ‘2’. Then click on the “Execute”.
No Item Explanation
During scheduling: Specify the start date or the latest start date you require for
2 Job start condition Fr. To your background job. To restrict the scope of the overview, specify the earliest
or latest start date for the overview.
Remarks
4. Background Job
Procedure 1) Check on the items ‘1’. Then click on either the item “Spool” or the item “Job log”.
No Item Explanation
Click on the check box of the job name you would like to
1 JobName
confirm.
Goes to “Output Controller: List of Spool Requests” Screen
2 Spool
(4-2-3 Page).
3 Job log Goes to “Job Log Entries for …” Screen (4-2-5 Page).
Remarks
4. Background Job
Procedure 1) Check on the items ‘1’. Then click on the item ‘2’.
No Item Explanation
Click on the check box of the job name you would like to
1 Spool no.
confirm.
Goes to “Graphical display of spool Requests …” Screen
2 Display contents
(4-2-4 Page).
Remarks
4. Background Job
This is the
Graphical display of
spool Requests …
screen. 1
Remarks
4. Background Job
Remarks