arcad-server 10.09.xx configuration guide · northamerica&latam emea(hq) asiapacific...

North America & LATAM EMEA (HQ) Asia Pacific70 Main Street, Suite 203Peterborough NH 03458USA1-603-371-90741-800-676-4709 (toll free)[email protected]

55 Rue Adrastée – Parc Altaïs74650 Chavanod/AnnecyFrance

+33 450 578 [email protected]

c/o Pramex Intl Ltd1 Austin Rd West Intl Commerce Centre7107B 71/F Tsim Sha Tsui HONG KONGYau Ma Tei Hong Kong

[email protected]

Configuration GuideARCAD-Server

Version 10.09.xx

Publication Date: September, 2018

Prepared by the ARCAD Software Documentation Team

ARCAD-Server v10.09.xxConfiguration Guide |

Copyright © 1992-2018 by ARCAD Software. All rights reserved.

The following terms are names owned by International Business Machines Corporation in the United States, othercountries, or both: AS/400®, ClearCase, ClearQuest®, DB2, DB2 Connect™, DB2 Universal Database™, ibm.com,IBM i, iSeries, System i, OS/400, Rational®, SP2, Service Pack, WebSphere. Java and all names based on Java areowned by Oracle Corp. in the United States, other countries, or both. Eclipse is a registered trademark of EclipseFoundation, Inc. Other names of companies, products or services are the property of their respective owners.

/ 57ARCAD Software • Copyright © 2018• All Rights reserved. • arcadsoftware.com

http://www.arcadsoftware.com/

ARCAD-Server v10.09.xxContact ARCAD Software | Configuration Guide

Contact ARCAD Software

Headquartered in France at the foot of the Alps, ARCAD Software offers global services and has offices andpartners all over the world. ARCAD partners with leading-edge companies throughout the world to ensureyou have the local support you need and best-of-breed contacts for all of your softwaremanagementsolutions. Our global partners are located strategically around the globe to offer full services, close tohome.

Visit our website to Contact Us and find out more about our company and partners!

ARCAD Software guarantees consultant support 24 hours a day, 5 days a week (24/5) to registeredmembers. Calls received are redirected to a central systemwhich, according to the hour, puts you in contactwith a consultant in or near your timezone.

The Customer Portal is intended for current and potential customers that have full or trial versions ofARCAD software. If you already use or are interested in using an ARCAD product, the portal lets you viewall of your current licenses and generate your own temporary license keys for most ARCAD products. Itgrants you access to the ARCAD product knowledge base (FAQ, new releases, fixes, etc.) as well as theRelease Notes and current documentation. Do you have a request for change or have you encountered abug? Log into the Helpdesk and create a ticket.

Country Address Contact

FranceARCAD Software (HQ)55 Rue Adrastée74650 Chavanod

+33 4 50 57 83 96 or Fax +33 4 50 57 52 [email protected]@arcadsoftware.com

USAARCAD Software Inc.70 Main Street, Suite 203Peterborough, NH 03458

+1 (603) 371-9074 or +1 (800) [email protected]@arcadsoftware.com

Germany

ARCAD Software Deutschland GmbHc/o Pramex International GmbHIm Trutz, Frankfurt 55,60322 Frankfurt am Main

Hong Kong

ARCAD Software Asiac/o Pramex Intl Ltd1 Austin Rd West Intl Commerce Centre7107B 71/F Tsim Sha Tsui HKYau Ma Tei

+852 3618 [email protected]@arcadsoftware.com

China

ARCAD Software Products Private LimitedOffice E05, 31st floorAgile Center26 Huaxia Road, Zhejiang New Town, Tianhe

+86 (020)22324643+86 (020)22324649

India D-280/281/282, Vibhuti KhandOpposite Urdu Academy, Gomti Nagar, Lucknow

Table 1: Contact ARCAD Software


https://arcadsoftware.com/about/contact/

https://arcadsoftware.com/customer/

http://helpdesk.drops-software.com/

mailto:[email protected]







ARCAD-Server v10.09.xxConfiguration Guide | Preface

Preface

Document purpose

This document is intended to guide ARCAD administrators through the configuration process of anARCAD Server using the command I_ARCAD or (ARCAD *SETUP).

The screen-shots that appear in this document are representative. They are intended to help understandthe product's functionality and do not necessarily demonstrate best practice. Because the user interfacecan be customized during installation, your emulator may look different than the examples in thisdocument.

In order to completely understand the notions in this document, you should have sufficient knowledge ofthe various functions available in the ARCAD-Core and ARCAD-Skipper.

ReferenceFor additional information for all of the screens and processes described inthis document, refer to the screen-by-screen, field-by-field F1 Help contentin your IBM i emulator.

Intended audience

This document is intended for System Admins, ARCAD Administrators and/or the person in charge of thehigh-level configuration of your ARCAD Server.

Related documentation

Unless stated otherwise, all content is valid for themost current version of ARCAD-Server listed as well asevery subsequent version.

Related documentation

ARCAD Release Notes

ARCAD Glossary

ARCAD SSL1 Configuration Guide

ARCAD-Administration Console Documentation

ARCAD-Audit Documentation

ARCAD-Core Documentation

ARCAD-Integrater Documentation

ARCAD-Observer Documentation

ARCAD-Skipper Documentation

ARCAD-Transformer Field DocumentationTable 2: Related documentation

1Secure Socket Layer



ARCAD-Server v10.09.xxPreface | Configuration Guide

Publication record

Unless stated otherwise, all content is valid for themost current version of ARCAD-Server listed as well asevery subsequent version.

Productversion

Documentversion Publication date Update record

≥ 10.09.xx 2.6 September,2018 No functional changes.

10.08.xx 2.5 June, 2018 Updated screen shot for license keys.

10.06.xx 2.4 June, 2016

No functional changes.

Changed title to refer to ARCAD-Core and not toARCAD Server specifically.Previous titles of content in this document: ARCAD-Server Configuration Guide.

Revised introduction.

10.06.xx 2.3 February, 2016 No functional changes.

10.05.06 2.2 September, 2015 No functional changes.Updated pagination.

10.05.06 2.1 June, 2015 No functional changes.

10.04.10 2.0 March, 2015 Content revised.Template updated.

10.02.02 10.03.03 Revised 1992-2014

Initial publication of this version.Previous titles of content in this document: ARCAD-System i Configuration Guide -and- ARCAD SolutionsConfiguration Guide.

Table 3: ARCAD-Core Configuration Guide publication record



ARCAD-Server v10.09.xxConfiguration Guide | Contents

Contents

Contact ARCAD Software 3

Preface 4

Contents 6

Tables 8

Figures 9

1 Introduction to configuring the ARCAD Server 10

2 Configure the library list 112.1 Adding libraries to a library list 11

3 Configure the sources 123.1 Controlling access to editable sources 123.2 Tracking sourcemovements 123.3 Installing the pre-compiler 13

4 Enter product keys (licenses) 14

5 Manage user profiles 155.1 Granting access to user profiles 155.1.1 About access levels 16

5.1.1.1 About access-level licenses 16

5.2 Defining functions for user profiles 175.2.1 The administrator(s) 17

5.2.2 The librarian(s) 18

5.2.3 The tester(s) 18

5.2.4 The application manager(s) 18

5.2.5 The database administrator(s) 18

5.3 Granting access to ARCAD-Observer and Verifier 195.4 Editing user information 195.4.1 About user identification 19

5.4.2 About user information 20

5.4.3 About parameter information 20

5.5 About the ARCAD user profile 205.6 About the ARCAD authorization list 21

6 Activate the Inter-system Robot 22

7 Manage ARCAD variables 237.1 Defining the variable parameters 237.1.1 Adding variable parameters 24

7.1.2 Editing variable parameters 24

7.1.3 Deleting variable parameters 24



ARCAD-Server v10.09.xxContents | Configuration Guide

7.2 Defining work item parameters 247.3 Defining document status variables 257.4 Defining version status variables 257.5 Defining application variables 257.5.1 Filtering the application variable menu 25

7.5.2 Editing application variables 26

8 Define data area parameters 278.1 ARDEVSIT/ARDEVSYS/ARQUADRA summary 47

9 Manage commands 489.1 Customizing ARCAD commands 489.2 Defining user options 489.3 Configuring XRef commands 49

10 Manage the compilation process 5010.1 Managing source types 5010.1.1 About source files 50

10.2Managing compilation types 5110.3 Managing object types 52

11 Manage clean up and debugging 5311.1 Running the clean up procedures 5311.2 Configuring automatic program bug recovery 5311.3 Configuring the debugging tool 53

12 Grant access to IFS user objects 54

13 Reinitialize 56



ARCAD-Server v10.09.xxConfiguration Guide | Tables

Tables

Table 1: Contact ARCAD Software 3Table 2: Related documentation 4Table 3: ARCAD-Core Configuration Guide publication record 5Table 4: Data area parameters 27Table 5: ARDEVSIT/ARDEVSYS/ARQUADRA summary 47Table 6: Source types 50Table 7: Compilation type variables 51



ARCAD-Server v10.09.xxFigures | Configuration Guide

Figures

Figure 1: Configuring the license keys 14Figure 2: Edit the list of ARCAD profiles menu 15Figure 3: Describing access level licenses 17Figure 4: Working with variable parameters 23



ARCAD-Server v10.09.xxConfiguration Guide | 1 Introduction to configuring the ARCAD Server

1 Introduction to configuring the ARCAD Server

After installation, the ARCAD Server must be configured according to your company’s needs.

ReferenceFor complete installation procedure instructions, refer to the ARCADInstallation Guide.

The following ARCAD modules require a connection to the ARCAD Server:

l ARCAD-Administration Consolel ARCAD-Auditl Open Repositoryl Event Managerl ARCAD-Deliverl ARCAD-Integraterl ARCAD-Observer

o Documentero DB

l ARCAD-Skipperl ARCAD-Transformer Field



ARCAD-Server v10.09.xx2 Configure the library list | Configuration Guide

2 Configure the library list

ARCAD products are structured according to the same principle as IBM software. All entry points arecommands or IBMmenu types and content is found in libraries.

Logging into the ARCAD Server via an emulator creates a session or an "interactive job". Everything on theIBM i is stored in libraries and one of the attributes of a session is a library list1. When a library is part ofyour session's library list, you have access to the objects inside of it.

There are two kind of library lists: the user-library list and the system-library list. A session's library list iscomposed of both (first the system libraries, then the user's).

Before beginning the configuration of your ARCAD Server, it's best to ensure the libraries are available onthe correct sessions and backed up.

All the software is restored in theARCAD_ENG and ARCAD_PRD libraries.

l ARCAD_ENG contains the language-dependent elements of the product.l ARCAD_PRD is the software library.

Important!For data security, it is highly recommended that you add these libraries toyour backup plan.

2.1 Adding libraries to a library list

To have permanent access to the product found in it, insert theARCAD_ENG library into the system partof your library lists in one of two ways:

l on a permanent basis by changing the system parameter using the QSYSLIBL command. It is highlyrecommended that you add the library this way. The library will always be available to all users on theIBM i.

l on a temporary basis using the command CHGSYSLIBL ARCAD_ENG. When a job session is closed,any changes made to a library are lost. You must have certain rights to call this command.

TheARCAD_PRD library is automatically managed by the product, so it doesn’t need to be explicitly addedto the library list.

1A list that indicates which libraries are to be searched and the order in which they are to be searched.



ARCAD-Server v10.09.xxConfiguration Guide | 3 Configure the sources

3 Configure the sources

Chapter summary3.1 Controlling access to editable sources 123.2 Tracking sourcemovements 123.3 Installing the pre-compiler 13

3.1 Controlling access to editable sources

The ARCAD_ENG library contains a copy of the STRSEU and STRSDA commands, which make it possible tointervene in the execution of these commands and checks aremade before the programmer1 changes thesource.

It is possible for the programmer to bypass the system controls by either:

l removing ARCAD_ENG from the system library list2 (if they are authorized to used the CHGSYSLIBLcommand).

l directly using the QSYS version of the QSYS/STRSEU or QSYS/STRSDA commands, in which case thechecks will not be performed.

Do the following in order to avoid both of these possibilities:

l restrict the authorization for the command CHGSYSLIBL (that is the case by default in the system).l restrict the access rights for the following commands (grant authority only to the ARCAD profile).

o QSYS/STRSEUo QPDA/STRSEUo QSYS/STRSDAo QPDA/STRSDA

3.2 Tracking source movements

The same principle applies to the removing, moving and copying of sourcemembers.

In this case, there is only one possibility because the commands which are controlled are the IBM icommands, therefore only present in the QSYS library (which is not the case for STRSEU and STRSDA).

Themethod consists of changing the system valueQSYSLIBL in order to add the ARCAD_ENG librarybefore the QSYS library in the list of the system libraries.

The ARCAD_ENG library contains a copy of the following commands:

1A user/profile with access to participate in application development.2A list that indicates which libraries are to be searched and the order in which they are to be searched.



ARCAD-Server v10.09.xx3 Configure the sources | Configuration Guide

l CPYSRCF

l RMVM (source member1 deletion)l RNMM (sourcemember2 renaming)

These three commands have a command processing program, which executes the control process. If youchoose this method of intervention, there is no further action to take.

If you do not want to have any checks on sourcemovements, delete the ARCAD copies of the followingcommands:

l DLTCMD ARCAD_ENG/CPYSRCF

l DLTCMD ARCAD_ENG/RMVM

l DLTCMD ARCAD_ENG/RNMM

The disadvantages are the same as those which have previously been mentioned. Therefore, make sure totake the same palliative actions.

3.3 Installing the pre-compiler

This system uses IBM iRouting Entries. For permanent installation, it is preferable not to add a subsystem,but to simply add a routing entry to the subsystem of your choice.

Follow the subsequent steps to add a new routing entry to a subsystem.

Step 1 Stop the subsystem.

Step 2 Add the following routing data as a new sequence number:

ADDRTGE SBS (sub-system name)

SEQ (sequence num.)

CMPVAL ('PRECOMP')

PGM(AART055G1)

Step 3 Restart the sub-system.

This will install the pre-compiler for this subsystem. This can be repeated for any subsystem.

NoteIn theory, you only need to add this routing entry into the subsystemwhich receives your compilations. However it is advised to enter it into allof, or themajority of the subsystems so that the pre-compiler is invokedwherever a compilation is done.

1A member that contains code (editable source material).2A container in an application that houses one or several objects.



ARCAD-Server v10.09.xxConfiguration Guide | 4 Enter product keys (licenses)

4 Enter product keys (licenses)

ARCAD Software is protected by a access keys. During the first installation, this key is automaticallygranted for a time limit which varies from 15 to 30 days.

Important!Only one installation is authorized per machine. Therefore, you cannotrenew the sampling period of the product by reinstalling it.

For a definitive installation, you must enter a new key. To enter the permanent key for an ARCAD product,select option 1 License/Key from the Installation/Parameter Menu (command: I_ARCAD).

Figure 1: Configuring the license keys

You are provided with the license key information by your distributor.



ARCAD-Server v10.09.xx5 Manage user profiles | Configuration Guide

5 Manage user profiles

Chapter summary5.1 Granting access to user profiles 155.2 Defining functions for user profiles 175.3 Granting access to ARCAD-Observer and Verifier 195.4 Editing user information 195.5 About the ARCAD user profile 205.6 About the ARCAD authorization list 21

IBM i user profiles are used to access the ARCAD system and products. Creating user profiles for an IBM ishould be done in advance. Only high-level users can create new user profiles using the CRTUSRPRFcommand.

Once created, the user profiles associated with the server can bemanaged in the Installation/ParameterMenu sub-menus.

To define the functions for user profiles and grant them access to ARCAD modules, select option 2 List ofARCAD profiles in the Installation/Parameter Menu (command: I_ARCAD).

The first and second columns in the table in the Edit the list of ARCAD profilesmen display the userprofiles that have access to ARCAD products and their defined access levels.

The following columns display the functions that can be assigned to the defined users. Each profile can beassigned one or several functions.

Figure 2: Edit the list of ARCAD profiles menu

5.1 Granting access to user profiles

In addition to assigning functions to a profile you must grant them access levels.



ARCAD-Server v10.09.xxConfiguration Guide | 5 Manage user profiles

The access levels are:

l 1: process manager (lowest level).l 2: open repository access.l 3: 5250 programmer1 (gives access to the 5250 Skipper interface).l 5: full developer seat (gives access to Skipper on a 5250 and in RDi2).

5.1.1 About access levelsAccess levels are nested, meaning that the lower level rights are built upon when a user is given more andmore access. If a user profile is granted an access level of 1 or 2, they are considered a simple user whereasgranting a user to access levels 3 or 5 activates developer and source codemanipulation rights, makingthem "programmers".

l Level 1 access allows a user to create and manipulate ARCAD's lists by calling ARCAD commands andto use the "macro maker".

l Level 2 access allows a user to do all of the above as well as load and browse the Open Repository.

ReferenceFor more information about themacro maker (the tool used to create,and manipulatemacros) and the repository, refer to theOpen Repository documentation.

l Level 3 access allows a programmer to do all of the above as well as check source components in andout of ARCAD-Skipper, open and close versions, and edit source code using a 5250 emulator.

l Level 5 access allows a programmer to do all of the above and gives them full access to the ARCAD-SkipperRDi plug-in.

Generally, all user profiles that manipulate sources using ARCAD should be given programmer accesslevels. This includes users with manager functions (refer to The application manager(s) on page 18).

NoteIt is recommended that the programmer profiles are given a group profilethat is authorized to create objects (refer to the GRPPRF and GRPAUTparameters for the CHGUSRPRF command). This will reduce possibleauthorization problems.

5.1.1.1 About access-level licensesAccess levels are controlled by your license. You cannot grant more profiles a certain access level than themaximum number specified in your license. If the number of profiles in your license is insufficient, contactyour distributor to increase this number. This increase is subject to charge.

Because access levels are nested, the licenses for access levels are as well. The image below describes thisprocess and indicates where you can check to see howmany licenses for each access level you have and

1A user/profile with access to participate in application development.2Rational Developer for i




have assigned. If a square covers more than one access level, it means that giving a profile this level willconsume one license for every level below it.

Figure 3: Describing access level licenses

5.2 Defining functions for user profiles

In addition to granting access levels to a user profile you must define their function(s). The functions are:

l the administrator1

l the librarian2

l the tester3

l the application manager4

l the database administrator5

5.2.1 The administrator(s)The administrator function has all authorizations in ARCAD and no access restrictions. In addition, onlyadministrators can declare new applications in ARCAD (refer to the ARCAD-Open Repository User Guide.

1A user role. The user responsible for configuration.2A user function. The user/profile responsible for the ARCAD configuration.3A user function. The user/profile responsible for version integration tests and validation.4A user. The user/profile responsible for the correct functioning of the application in relation to the users.5A user function. The user/profile responsible for verifying the consistency and avoiding redundancy in the database.




If you wish to respect the hierarchy established in the system, you can use theQSECOFR1 profile for anadministrator. You can also use any other profile, exceptQPGMR2.

5.2.2 The librarian(s)The librarian function should be given to the user profile(s) responsible for the reference version of anapplication and the operational versions on each site. This user will transfer new versions into productionand distribute them to each site.

Note the following:

l Do not specify QPGMR. In principle, this user profile must be independent of the development team.l You can specify QSECOFR.l Librarians can be given any access level you consider appropriate.

5.2.3 The tester(s)The testers are part of the validation circuit of a version before it goes to production. There is no restrictionon the profiles that are defined as testers; you can specify any profile on your system.

The list of testers is found in ARCAD-Skipper in the definition of the version testers. It is also found in theARCAD-Customer as part of themaintenance report3. The project manager specified in anMR4mustbelong to this list.

5.2.4 The application manager(s)An application is created in ARCAD and the application manager function is defined in it, not in the Edit thelist of ARCAD profilesmenu.

If a user profile is an application manager on at least one application, an X will appear in theApp mngrcolumn.

Application managers are responsible for the quality of an application in relation to the users. They receiveincident reports and change requests issued by the users and must follow up on opened versions and theirintegration.

Each application can only have onemanager but one profile can managemany applications. An applicationis required to have an application manager.

5.2.5 The database administrator(s)An application is created in ARCAD and the database administrator function is defined in it, not in the Editthe list of ARCAD profilesmenu.

1The master security office profile on IBM i.2The default IBM i programmer profile.3(MR) A technical document used by the application development department to follow up the applicationmodifications.4Maintenance Report




If a user profile is an database administrator on at least one application, an X will appear in theDB admcolumn.

Database administrators are responsible for verifying consistency and avoiding redundancy in a database.They are in charge of physical and logical file creation and checkout operations in application versions.

Each database can only have one administrator but one profile can administer many databases. Anapplication is not required to have a database administrator.

5.3 Granting access to ARCAD-Observer and Verifier

Access to ARCAD-Observer and ARCAD-Verifier is granted from the Edit the list of ARCAD profilesmenu.

Add an X in the corresponding row for every user that should have access to either of these products.

Like access levels, access to these products is based on licenses. Refer to Figure 3: Describing access levellicenses.

5.4 Editing user information

Personal information is linked to the use of ARCAD products so that the profiles can be grouped bylocation or department for ticketing and to track who access what content.

Selecting option 3 List of users from the Installation/Parameter Menu (command: I_ARCAD)displays theWork With Usersmenu which contains the defined user profiles.

Select option 2 Edit for any profile to change the access levels and personal information.

Press the Enter key to validate any changes made (pressing F3 or F12will ignore any changes).

5.4.1 About user identificationA user's ID information consists of the following fields:

User [Required] The full name of the person who uses this profile. For example, John Doe.

System [Required] The name of the IBM i server system the profile is created for.

Name of user profile [Required] The profile name used to log into the system. Like all IBM i objects,profile names cannot exceed 10 characters.

Device used [Outdated] The name of the user's terminal. This is no longer necessary information.

Device type [Outdated] The user's terminal type. This is no longer necessary information.

Remote user ID [Optional] The user's network ID.

Address [Optional] The user's network ID address.




5.4.2 About user informationThe user's detailed information consists of the following fields:

Department [Optional] The name of the company department the user is part of. The value(s) availablehere are variable parameters. For more information about editing these values, refer to Defining thevariable parameters on page 23.

Site [Optional] The name of the company site the user works at. The value(s) available here are variableparameters. For more information about editing these values, refer to Defining the variable parameters onpage 23.

Office [Optional] The name of the office the user works in.

Function [Optional] The user's job title.

Telephone Number(s) [Optional] The user's telephone number(s).

Email address [Optional] The user's email address. It is recommended to enter an email address for a userbecause certain ARCAD functions send emails to the address listed here.

5.4.3 About parameter informationThe parameter information section is found on the second page of the user's information.

Exclude automatic branching upon error? Adding an X to this field disables the automatic IR1 created byARCAD when a program "crashes". This is especially useful for programmers because an IR will not becreated every time a bug stops their work.

5.5 About the ARCAD user profile

During installation, a user profile called ARCAD is automatically created on your machine. It is the product'sobject2 ownership profile.

If you come across bugs in the products linked to authorization problems, you must increase theauthorization linked to the ARCAD profile.

By default, the profile is created with these special rights:

l *SECADMl *ALLOBJ

Important!All the necessary safeguards are built into the products so that the usercannot adopt these authorities in order to enter any command. Onlyspecific commands can be run with these special authorities.

1Incident Report2An IBMi component.




5.6 About the ARCAD authorization list

All product object are protected by an authorization list created during installation called ARCAD. If youwant to extend or limit access to data contained in the products, you must use this authorization list.



ARCAD-Server v10.09.xxConfiguration Guide | 6 Activate the Inter-system Robot

6 Activate the Inter-system Robot

The Inter-system Robot process, which runs in the background, carries out several functions in ARCAD:

1. It ensures the transfer of user documents1 from remote sites to the development site.2. It ensures the return of any maintenance reports corresponding to the sites.3. It automatically receives objects sent to a site.4. It can run commands from another system (see command ASNDRMTCMD).5. It restores macro-commands received from the network.6. It can handle the send/receive of transfer logs/history.

To activate it, select option 4 Inter-system Robot from the Installation/Parameter Menu (command: I_ARCAD).

This option will handle the following:

l the declaration of the default profile (ARCxx_NET) in your directory network (WRKDIRE command);l the start/restart of the robot job in the ARCAD sub-system (you can identify this job by its "function":CMD-AMSGCMDE).

1Digital reports produced by a user to report an incident encountered or propose a modification.



ARCAD-Server v10.09.xx7 Manage ARCAD variables | Configuration Guide

7 Manage ARCAD variables

Chapter summary7.1 Defining the variable parameters 237.2 Defining work item parameters 247.3 Defining document status variables 257.4 Defining version status variables 257.5 Defining application variables 25

This chapter describes the different variables that you can customize for maintenance reports and timesheets managed by ARCAD-Customer.

All of the variables are controlled from the Installation/Parameter Menu (command: I_ARCAD).

7.1 Defining the variable parameters

Selecting option 5 Variable parameters displays theWork with Variable Parametersmenu.

These parameters are also available in the incident-report and change-request menus (ARIRDOC andARCRDOC) in ARCAD-Customer.

The list of default parameters is displayed. You can edit them and/or create new variables.

Figure 4: Working with variable parameters

(AC) Actions taken Used to define the list of different levels of corrective actions possible for anMR1.

1Maintenance Report



ARCAD-Server v10.09.xxConfiguration Guide | 7 Manage ARCAD variables

(IT) Action Type Used to define the list of different types of actions possible when filling out a time sheetin ARCAD-Client.

(KY) Document keywords Used to associate a list of keywords to an MR in order to create search criteria.

(LG) Language ID Used in SiteManagement (AWRKSIT) to define the list of possible languages that can beused to define ARCAD products.

(ME) Delivery types Used in SiteManagement (AWRKSIT) to define the list of possible delivery types forARCAD-Deliver.

(MX) Maintenance types Used to define the list of different types of maintenance requests for an MR.

(PS) Time sheet position Used to define the list of different stages in project development possible whenfilling out a time sheet in ARCAD-Client.

(SI) Sites (on IR/CR doc) Used in User Management (AWRKUSR) to define the list of possible company sitesa user can be located at.

(SV) Departments (on IR/CR doc) Used in User Management (AWRKUSR) to define the list of possibledepartments a user can be in.

7.1.1 Adding variable parametersYou can add new parameters for any of the variables listed above using the F6 key (Add).

Because certain parameters in the product have a reduced size, the length of an added value is checked.

7.1.2 Editing variable parametersSelecting option 2Change for a given variable displays theWork With Variable Parameters screen whichenables you to edit its parameters.

Edit the text directly on this screen for existing parameters, or use the F6 key to Add a new one.

Press the Enter key to validate the change (pressing F3 or F12will ignore any changes).

7.1.3 Deleting variable parametersYou can delete the parameter codes that were previously added (using the F6 key) by selecting option 4Delete. Because they are actively used in the product, default parameters cannot be deleted.

Important!Deleting a parameter value does not update the ARCAD database. If youwant to update the database, you must first manually replace everyinstance of all the values you wish to delete. It is therefore advisable to setthese values before the product is used.

7.2 Defining work item parameters

Selecting option 6 Parameters for work items displays theDocument Parameter Settingmenu where



ARCAD-Server v10.09.xx7 Manage ARCAD variables | Configuration Guide

you can define the status of a document upon it's creation and then upon it's inclusion in a version.

Press F9Work with document status for any field to redefine or add a status variable.

ReferenceFor more information about document statuses, refer to Definingdocument status variables below.

7.3 Defining document status variables

Selecting option 7 Possible status for documents displays theWork with Reference Document Statusmenu where you can manage the variables used for statuses around ARCAD.

Press F6 Add to add a new variable to the list.

Use this parameter in conjunction with the ARDEVSIT and ARDEVSYS parameters. Refer to Define dataarea parameters on page 27.

7.4 Defining version status variables

Selecting option 8 Possible status for versions displays theWork with Version Statusmenu where youcan manage the variables used for versions around ARCAD.

Press F6 Add to add a new variable to the list.

7.5 Defining application variables

Selecting option 20 Application variables displays theWork with application variablesmenu where youcan manage the variables that define the development environment in which modifications are carried outfor different ARCAD applications. The command AWRKAPPVAR also enables you to access this menu.

Application variables can be related to:

l an environment (Application, environment or version);l a site (with or without application, environment).

7.5.1 Filtering the application variable menuUse the fields at the top of themenu to define the scope of the applications to view/edit. You can enter thefollowing values for all of the filter options:

l *ALLl *NONEOnly variables that are not linked to an application will be displayed.l Name You can enter the name of an existing application.l *Select Enables you to select the value of the filter from a list



ARCAD-Server v10.09.xxConfiguration Guide | 7 Manage ARCAD variables

7.5.2 Editing application variablesWhen the scope is defined, press enter. The table displays the following information which can be edited byselecting option 2Modify:

Group Groups of variables are used to address a specific need where several variables are to bedefined. They can also be subdivided using the group value. A group must be created before variables canbe attached to it. The AADDAPPVAR command is used to create a group. You must enter a name for thegroup and specify ENVTYPE(*NONE).The same variables may be defined several times in the same group,but with different environments (or sites).

Group Value A group value is an optional sub-entity of a "group" which allows several variables to bebrought together. A group value is always attached to a group. In order to be able to attach a variable to agroup value, the group/group value pair must be created first. The AADDAPPVAR command is used tocreate a group value. You must enter the group name, the group value, and specify ENVTYPE(*NONE).

Variable name (VAR) Each variable has a name, the length of which varies from 1 to 50 characters. A nameshould start with an alphabetic character, and include alphanumeric characters and possibly the "_"character. Variable names starting with the prefix ARC_ are reserved by ARCAD for specific uses.

The following names define the values for the access to a remote system by themulti-platform executionagent.

l ARC_HOSTNAME is the network name of the target system.l ARC_PORT is the listening port number (default value is 8230).l ARC_USER is the user profile for the connection to the target system.l ARC_PWD Is the password associated with the profile.

The following variables are also to be defined if you would like themulti-platform execution agent toperform SQL1 access on a database on the remote system.

l ARC_SQLDRIVER is the JDBC2 driver name to be used (example: 'com.ibm.db2.jcc.DB2Driver' for aconnection to a DB2 database).

l ARC_SQLURL Is the URL to access the target database. (example:'jdbc:db2://localhost:50000/xxx' forthe DB2 database named xxx).

l ARC_SQLUSER is the profile for the connection to the database. You can specify *USER if this profileis the same as the profile defined in variable ARC_USER.

l ARC_SQLPWD is the password for the connection to the database. You can specify *PWD if thispassword is the same as the password defined in ARC_PWD.

Variable value (VALUE) A field of 1 to 250 characters. This field can be encrypted if it corresponds to apassword. If encrypted, the content is replaced by ******* if you are not authorized to modify it.

1Structured Query Language2Java Database Connectivity



8 Define data area parameters

ARCAD includes some parameters stored in data areas.

Selecting option 9 Other parameters from the Installation/Parameter Menu (command: I_ARCAD) displays the list of data areas.

To access or edit a data area, you can also use the AEDTDTAARA command.

NoteIf you useRDi1, you can download a data area editor plug-in, which is provided as a freeware, from our website.Visit the website

The following table contains information about each parameter (listed in alphabetical order), including which ARCAD module it affects and adescription of the possible values.

NoteIf the default value refers to ARCxx, the xx is the instance. The default ARCAD instance is ARCAD.

Name Type/Length Default value ARCAD module(s) Description

ARANZLIB *UNICODE/10 ARCxx_TCA TCA (TestCoverage Analyzer)

This parameter contains the name of the library used to storeanalysis files generated by the TCA. This analyzer tracks thetest execution of the program code lines shown by parametersand constitutes test coverage data for each program.

Storage library for test coverage analyzer

Values: Library name used in TCA process: a work library whereTCA data are stored.

ARAUTOMSGQ *UNICODE/10 *SYSOPR Process manager

*New to v10.05*

MSGQ for Inter-Systems automate. Name of themessagequeue where Arcad automate sends messages that need

Table 4: Data area parameters

1Rational Developer for i


ARCAD-Server v10.09.xx8 Define data area parameters | Configuration Guide

http://arcadsoftware.com/resource-items/data-area-editor-freeware



answers.

Values: *SYSOPR or anMSGQ name

ARCKTMPLIB *UNICODE/4 CHK Observer &Transformer DB

*New to v10.05*

Default prefix for "Data/Constraint Check" lib.

Value: First characters/prefix for library names generated byArcad when checking Data integrity or constraint on anothersystem.

Value: Prefix for the temporary library.

Don’t forget to change when several Arcad Instances could usethis feature on the same system.

ARCMDINT *UNICODE/4 *NO Skipper & Verifier

*New to v10.05*

Command interception trace.

Values:

*NO When a command is intercepted by Arcad, there is noinformation message in the log.

*YES Each time a command is intercepted by Arcad, amessage is placed in the log.

ARCPLREF *UNICODE/4 *YES Repository

Authorized compilation from repository.

Values: *YES/*NO

If the value is changed to *NO, option 9=Compile is notallowed from the repository (ADSPOBJREF).


ARCAD-Server v10.09.xxConfiguration Guide | 8 Define data area parameters




ARCPNY *UNICODE/30 ARCAD DEMO All

This parameter contains the name of your company. It willappear in themajority of screens.

Values: Text. Company name printed in different spools

ARCQWEB *CHAR/2000 prox... Skipper

This is only for the old IBM Rational ClearQuest interface (notRTC1). There are very few uses today.

Values:Multiple parametersTable 4: Data area parameters

1Rational Team Concert





ARCTGLMT *DEC/3,0 010 Skipper

This parameter allows you to set themaximum number ofhistory entries (versions) in the SourceMember Header section(cartridge). This section appears at the top of a source editedusing ARCAD-Skipper. There is one entry for each version.

Values: 001-999

ARCTLJOBQ *UNICODE/20 ARCxx_CTLARCAD_SYS Process manager

This parameter contains the JOBQ used by themacro-command processor. When executing amacro line/sequencedefined as a batch1 execution (mode 'B'), the command issubmitted to the job queue specified here.

This job queue entry must:

1. allowmultiple simultaneous active jobs and2. be active when themacro is executed.

Values:

l Position 1-10, name of the JOBQl Position 11-20, library of the JOBQ

It defines a JobQ used by Arcad to submit control jobs, likeARCxx_CTL job. This JobQ is connected to an active ARCADsub-system, with *NOMAX for number of active jobs.


1IBM term meaning that something runs in the background.





ARCUST *UNICODE/15 ARCAD DEMO All

Customer Identification

Values: Local site code used (as ARCPNY) to be printed in somespools.

ARCUSTLIB *UNICODE/10 ARCxx_CUST Process manager

Customer library. Used only by the AWRKMACCMD command asa special value for library.

Values: Library nameTable 4: Data area parameters





ARDEVSIT *UNICODE/15 SNADS Skipper & Deliver

Development site name used as a key element in userdocuments1 and maintenance reports, and inTCP/IP communications to retrieve transfer historyinformation for the sourcemachine (DSPTFRLOG).

Use this parameter in conjunction with the ARDEVSYSparameter and the document status parameter(s). SeeDefining document status variables on page 25.

Refer to ARDEVSIT/ARDEVSYS/ARQUADRA summary onpage 47.

ARDEVSYS *UNICODE/10 ARCAD05D Skipper & Deliver

This parameter defines the development site (maintenance sitesystem name). It is used to automate the delivery of incidentreports and change requests to the site designated as thedevelopment site.

When an IR2 or CR3 is sent by a user and the system on whichthe document has been created is not the development site, ifthe robot is active, the document will be automatically sent tothis site.

It is also the inter-systemmessenger (SNDAPPRMSG, SNDUMSG).

Use this parameter in conjunction with the ARDEVSITparameter and the document status parameter(s). SeeDefining document status variables on page 25.



1Digital reports produced by a user to report an incident encountered or propose a modification.2Incident Report3Change Request





ARDLTLMT *UNICODE/4 *NO Skipper

Deletion functions for Version Manager.

Values:

*NO No special check.

*YES The ADLTOBJARC and ARNMOBJAC commands arelimited to the version project leader1.

ARDLTSPL *UNICODE/4 *YES Process manager

Automatically delete old Spool file.

Values:

*NO When a compilation is done by ACPLOBJ, no old spool isdeleted.

*YESWhen the compilation is done by ACPLOBJ, old spoolsfor the same component, and the same user, are deleted at thebeginning of the compilation process.


1The person responsible for the application modifications in the context of an application version.





ARDLVPATCH *UNICODE/4 *NO Deliver Server

*PATCH Mode - Lock at the version Level.

Values:

*YESWhen a create a delivery for *PATCH type, it checks thattarget version is greater or equal than the version installed onthe environment

*NO No control.

ARDOCXID *UNICODE/4 *NO Skipper

*New to v10.05*

Unable to changeMR1 External ID

Values:

*YES In AEDTMNTRPT screen, the External Id can’t bechanged.

*NO It can be changed.Table 4: Data area parameters

1Maintenance Report





AREDTDSP *UNICODE/4 *YES Skipper

Re-display Document/Component link screen

Values:

*YES The 5250 screen where you display/enter the documentlinked to a component for a version is always displayed whenediting the source.

*NO When a component already has a link to a document forthe version, the 5250 screen is not displayed when editing thesource.

AREDTFORC *UNICODE/4 *YES Skipper

This parameter specifies whether it is possible to bypass thelock for source editors.

Values:

*YESWhen the same component is in development in severalopen versions, after having been released, it’s possible to editit in these versions.

*NO When the same component is in development in severalopen versions, you must release each time you want to changeit for a version, even it has been already changed in theversion.






AREXTLIB *UNICODE/10 ARCxx_EXT Extract

Library for XML *ARCEXX

Value: Name of the work library where Arcad Extract storestemporary information.

AREXTMPLIB *UNICODE/8 S L Extract

Dft Pfx for EXTRACT Libraries: "S L"

Value: First characters for library names

Prefixes for the library names generated byARCAD-Extract forlibraries created for an extraction/injection

Position 1-4: Prefix for the temporary library for macros andArcad request

Position 5-8: Prefix for the temporary library for resultextracted data

Don’t forget to change themwhen several Arcad Instancescould use ARCAD-Extract on the same system.






ARFADMMOD *UNICODE/7 *MANUAL Skipper

This parameter is only used on remote production sites. Itdefines the delivery mode of an IR/CR to the development site.

Configures the preparation options display for themanagement of a multi-criteria IR/CR and allows the requestto be sent automatically.

Values:

*MANUAL They are not sent automatically.

*AUTO They are sent after creation.

ARGDSTATT *DEC/3,0 003 Deliver Server

*New to v10.05*

Wait delay for Deliver Server engine. Wait delay (in seconds)for the deliver server engine, before it checks again if somenew process must be done.

Values: 001-999

ARHLPMAC *UNICODE/4 *NO Process manager

Help available on parameter of macro-command

Values:

*YESWhen you edit the parameter of a macro-command, awindow asks you whether you want to edit its online help.

*NO Use option 20 when editing amacro (AEDTMACCMDlib/macro > F15 [parameters]) to edit the online help.

ARHSTMAC *DEC/3,0 015 Process manager

Default number of themaximum number of macro logs tokeep, (used only when you create a newmacro).

Values: 001-999

ARIWSLIB *UNICODE/10 HA2SLIB Adelia interface*New to v10.05*

Adelia/IWS product library name.Table 4: Data area parameters





Values: Library name

ARIWSVERB *UNICODE/4 *YES Adelia interface

*New to v10.05*

Adelia/IWS Interface verbosemode.

Values:

*YES "Verbose"mode. Many information messages arelogged when Adelia compilations are intercepted by Arcad.

*NO Just the last message (error/ok) is sent.Table 4: Data area parameters





ARJOBQ *UNICODE/20 ARCxx ARCAD_SYS Process manager

JOBQ/library for Arcad Sub-system

Values:

Position 1-10: name of the JOBQ

Position 11-20: library of the JOBQ

It defines the Job Queue that is used:

l when a job is submitted using AEXCCMD or APMTCMDwith JOBQ(*ARCAD)

l Value for automaticmacro variables: &AARCJOBQ and&AARCJOBQLI

This jobq is connected to ARCAD sub-system, with 1 fornumber of maximum of active jobs.

ARKEYSCTRL *UNICODE/200

MM: *NO

OpnR: *NO

Chg: *NO

ChgC: *NO

WDSC: *NO

Obs: *NO

Vrf:*NO

All

Control Users when ARCAD licenses are delivered for anunlimited number of users.

Values for each of the seven ARCAD products (10 characters)in the list:

*NO The corresponding product(s) can be used by any user,even if not declared in ARCAD.

*YES Each user must be defined in ARCAD.

ARKEYSTMP *UNICODE/30

MM: *YES

OpnR: *YES

Chg: *YES

All

Authorize temporary ARCAD user. Only used when an ARCADlicense code is valid for a product, but not allowed for the user.

Values for each of the three ARCAD products (10 characters) inthe list:

*NO An undefined user can’t use the product.Table 4: Data area parameters





*YES The user can force the possibility to use the product, butonly for one user at a time (and for the current day).

ARLDA *DEC/4,0 0800 Process Manager,Skipper

This parameter contains the position to which ARCAD willupdate information in the local data area (*LDA). This is toavoid conflict with your own applications that use the *LDA.

The value of this parameter is numeric and must be less than900, as ARCAD needs aminimum of 126 characters.

Start position for writing in LDA (<900).

Arcad needs to use 40 characters in the *LDA of the job tostore:

l Current Application/env/Version (28 positions)l Current Validation identification for transfers (12positions)

Specify ARCAD's starting position.

Value: numeric value from 001 to 899Table 4: Data area parameters





ARLSTNCTL *UNICODE/10 LSTXREF Skipper

*New to v10.05*

List for held components in ACRTVERLST.

Values: Name of a list (stored in version library) which the heldelements will be held by ACRTVERLST in LSTNCPL lists – toavoid need of recompilations.

ARLSTXREFS *UNICODE/4 *YES Skipper

Xref for modified copy. When editing a Copy clause source,ARCAD can fill the LSTXREF list with the components thatmust be recompiled.

Values:

*YES this list is updated.

*NO this list is not changed.

ARMXLIBL *DEC/5,0 00200 Process Manager

Maximum number of libraries that are allowed when definingthe LIBL for an application/environment/version.

Values: 0015-0255

ARMXLIBOPE *DEC/5,0 00100 Process Manager

Maximum number of libraries that are allowed when definingthe operational libraries1 linked to anapplication/environment/version.

Values: 0001-0250

ARMXLIBSYS *UNICODE/8 *NO 0015 Process Manager

Maximum number of SYSLIBL lib in libl + authorization. Arcadcan authorize to change the System Library list when definingthe LIBL for an application/environment/version. Be careful, itsonly if your application needs to change it depending on eachenvironment – reserved for "system" software. Choosing*YES, authorizes it, and you will have "S=System" libraries


1The libraries that define the structure of an application or an environment.





when you edit the LIBL of anapplication/environment/version. The number of possiblelibraries is limited to 15 by the OS.

Values:

Position 1-4: *YES/*NO

Position 5-8: 0010-0015

ARNETLIB *UNICODE/10 ARCxx_NET Deliver

The name of a library used to send/restore data, save fileswhen they are send from one system to another. This library iscleaned by ARCLNUPmacro.

Value: Library nameTable 4: Data area parameters





AROUTQ *UNICODE/20 ARCxx ARCAD_SYS Repository

Defines the Out Queue that is used for spools generated forXRef update processes. These spools are deleted immediatelywhen no error occurs, but invalid compilation spool stayed inthis *OUTQ. OUTQ/library for Arcad Sub-system.

Values:

Position 1-10: name of the OUTQ

Position 11-20: library of the OUTQ

ARQUADRA *UNICODE/16 ARCADARCAD05D Deliver

User ID and address used for sending documents to thedevelopment center. It is used for the SNADS network forsending:

l user documents to the dev center (SNDUSRDOC)l transfer histories to the dev center (SNDTFRLOG)l maintenance reports to sites (SNDMNTRPT)l version info to sites (SNDVERINF)l inter-systemmessages (SNAPPRMSG, SNDUMSG)

Use this parameter in conjunction with the ARDEVSYSparameter and the document status parameter(s). SeeDefining document status variables on page 25.


ARSRVEXP *UNICODE/4 *YES Skipper

Generate an Export source for *SRVPGM by version. Used fordefault management of ILE exported source (to manage theILE signature(s) of "service programs").

Values:

*YES By default, Arcad manages it for you. When nothing isdefined for a service program in its ILE link attributes, it






considers that the ‘*VERS’ method management is done, so itcould generate new "BND" sources, that could ensure acompatibility with new/old signatures.

*NO By default, nothing is done automatically by Arcad.When nothing is defined for a service program in its ILE linkattributes, it considers that the ‘*NOVERS’ methodmanagement is done : so all of the program that use it must berecompiled, if the signature changes.

ARTIMWAIT *DEC/10 0000000025 Process Manager

This parameter contains the lock-wait-time for an object1. It isused in the ARCAD command ALCKOBJ. Waiting period(number of seconds) that the systemwaits for, when an objectthat wewant to lock (during a transfer) is locked by anotherjob. After this period, it executes the action that has beenchosen when the lock fails.

Value: 0000000001-000003500Table 4: Data area parameters

1An IBMi component.





ARTRGLIB *UNICODE/10 ARCxx_TRG Process manager

The name of a library used for themechanism of triggersubstitution (used for tests, when 2 different occurrences ofthe same external trigger program could be called by thetrigger action that is set on a file, depending on the librarylist1).

Value: Library name

ARUSRDCL *UNICODE/4 *YES Repository

User capability to declare new application.

Values:

*YES A user, who is not an Arcad administrator2, is allowed todeclare a new application.

*NO The declaration of new application is limited to Arcadadministrator.

ARVRFLIB *UNICODE/10 ARCxx_VRF Verifier

*New to v10.05*

Verifier overridden command library.

Value: Name of the library where all the intercepted commandsused for Arcad Verifier are stored.

ARVRFLIB2 *CHAR/16 VRPYVBASVDCX Verifier

Prefix for Verifier libraries

Don’t forget to change themwhen several Arcad Instancescould use Arcad_Verifier on the same system.

ARXREFCPL *UNICODE/4 *YES SkipperXref type for ACPLOBJ in AWRKOBJARC *YES/*LVL. Type ofXRef used to load dependent programs in the list LSTXREF,when a compilation is done by Option 9, from AWRKOBJARC.


1A list that indicates which libraries are to be searched and the order in which they are to be searched.2A user role. The user responsible for configuration.





Values:

*YES All the programs using a compiled file will be added tothe LSTXREF list.

*LVL They are added to the LSTXREF list, only if their formatlevel Id has changed.

ARXREFDMP *DEC/5 00005 Repository

Maximum number of dumps per Arcad Xref Anomaly. Whenan (abnormal) Arcad error occurs during Xref calculation(APUDPXRF), it generates a formatted SAVFwith dumps. Thisparameters limits themaximum number of SAVF for the sameerror than occurs many time in the same Xref calculation.

Values: 0001–0020Table 4: Data area parameters




8.1 ARDEVSIT/ARDEVSYS/ARQUADRA summary

On the local site, verify and modify the content in the ARDEVSYS Dataara and in the local site parameter ARDOCSIT.

On the remote site, verify and modify the content in the ARDEVSYS and ARQUADRA Dataaras and in the local site parameter ARDOCSIT.

ReferenceDefining document status variables on page 25

DTAARA Name Local machine Remote machine

ARDEVSIT Dev Site ASLOCAL ASLOCAL

ARDEVSYS Local Site SITE_LOCAL SITE_LOCAL

ARQUADRA User & machine n/a ARCAD ASLOCALTable 5: ARDEVSIT/ARDEVSYS/ARQUADRA summary




ARCAD-Server v10.09.xxConfiguration Guide | 9 Manage commands

9 Manage commands

Chapter summary9.1 Customizing ARCAD commands 489.2 Defining user options 489.3 Configuring XRef commands 49

All of the commands in ARCAD are controlled from the Installation/Parameter Menu (command: I_ARCAD).

9.1 Customizing ARCAD commands

The fact that all the entry points to ARCAD Server are commands contributes to its capacity to beparametrized. If the parameters are not set, the default values are run when a command is called.

Parameter settings are controlled using the CHGCMDDFT command. In order for parameter customizationto be persistent, the changes madewith the previous command must bememorized. If the customizationisn't persistent, the changes made to ARCAD commands are lost when the product is upgraded.

Selecting option 10 Customization of ARCAD commands enables you to memorize the parametersettings to carry out on the server's commands. These changes can be:

l changes to the default values of the command parameters;l changes to Authorization for certain objects;l attribute changes (database files, printer files, etc.).

This function uses the ARCADmacro-commands processor. You can directly insert your changes into thePRDNEWVER macro or use the record mode of themacro-command processor.

All changes must be recorded with the customization macro in order to re-execute them during theinstallation of a newARCAD version.

During the installation of newARCAD versions, this macro will be run automatically. Therefore itautomatically re-applies all of your parameter settings.

You can use this system to memorize your changes to the default values of the system, because the sameproblem occurs when the IBM i version loads.

ReferenceFor more information about creating and managing macros, refer to theARCAD-Core Macro Maker User Guide.

9.2 Defining user options

Use option 16 User Options on page 2 of the Installation/Parameter Menu) to add user-defined optionsfor the programmers (used like PDM user options), some of which have been defined by ARCAD. These



ARCAD-Server v10.09.xx9 Manage commands | Configuration Guide

options are in named groups for use in specific contexts.

The named group (set of options) can be specified on certain ARCAD commands and function as "toolbars"in some ARCAD screens. These are shortcut commands which are usually called on list entries. Shortcutsare defined once and then available to every user.

ExampleWhen working with components in a version, the Arcad commandAWRKOBJARC is used. This uses, by default, the set of user options namedAWRKOBJARC, but this can be prompted and changed: USROPT(AWRKOBJARC).

9.3 Configuring XRef commands

Selecting option 19 Set XRef commands enables you to create, view and edit cross-reference commands.The cross-references enhance the references compiled when commands are used (in CLP/CLLE or MENU).

By default, the system provides some cross-references for commands. The parameters managed in thismenu define standard, or specific values that will automatically help complete the cross-reference for ananalyzed source.

To access or edit the cross-reference commands, you can also use the AWRKXRECMD command.



ARCAD-Server v10.09.xxConfiguration Guide | 10 Manage the compilation process

10 Manage the compilation process

Chapter summary10.1 Managing source types 5010.2Managing compilation types 5110.3 Managing object types 52

The ARCAD compilation process is managed from the Installation/Parameter Menu (command: I_ARCAD).

10.1 Managing source types

To manage source types, either select option 11Work with source types on page 2 of theInstallation/Parameter Menu, or run the AWRKSRCTYP command.

Ensure that all of source types that you manipulate are present in the list. In principle, the largemajorityhave been identified; at the very least the IBM i standard types should be. You can however add your ownsource types.

The following are default parameters that can be redefined for every individual application.

10.1.1 About source filesThe allocation of one source file to a source type is very important for organization because it is this thatdetermines the physical location of new components.

For each source-type/source-file combination, it is possible to automatically specify the destination of thesource member1 and the corresponding object2. This identification is carried out using the notion oflibrary type.

Each library-type corresponds to one of the libraries defined by the operational attributes of the application(see option 1 on the AWRKAPP command menu).

Library Type associated

source *L01

objects *L02

Files 1 *L03

Files 2 *L04

Files 3 *L05Table 6: Source types

1A member that contains code (editable source material).2An IBMi component.



ARCAD-Server v10.09.xx10 Manage the compilation process | Configuration Guide

Library Type associated

dependent 1 *L06

dependent 2 *L07

dependent 3 *L08

dependent 4 *L09

dependent 5 *L10Table 6: Source types

If the processed source type does not have a corresponding object, then choose the value *NONE.

If this position cannot be automatically determined by this combination1, the *SELECT valuemust bespecified. This value will display a screen requesting the location during the addition of a component, tospecify the library in which the source and the object must be placed when they are added to therepository.

10.2 Managing compilation types

This is an ARCAD value described in detail in the ARCAD-Skipper User Guide.

If your source type has to be compiled, define the compilation type. This will be used by the compilationcommand ACPLOBJ.

To manage compilation types, select option 12Work with compilation types on page 2 of theInstallation/Parameter Menu. The settings enable the execution of the appropriate compilationcommand.

It is only used in the ACPLOBJ command.

Management of the compilation command can be carried out either internally (*INT), if it is an IBM icommand, or externally (*EXT) if you want to specify the command that is used. For performance reasonsit is preferable to leave it as internal management. For external management, you must specify thecommand to be executed using substitution variables. The table below shows the list of variables that canbe used.

$F To retrieve the name of the source file.

$L To retrieve the source library of the component.

$N To retrieve the name of the component to process.

$O To retrieve the creation library where the generated object is to be placed.

$T To retrieve the sourcemember2 type.Table 7: Compilation type variables

1This is the case if your applications contain many source libraries with identical source file names.2A container in an application that houses one or several objects.



ARCAD-Server v10.09.xxConfiguration Guide | 10 Manage the compilation process

10.3 Managing object types

Use option 13Work with object types on page 2 of the Installation/Parameter Menu to manage theobject type1(s).

In the sameway that the source-type/source file combination determines the destination library, you canspecify the location for new objects without sources that will be created. This information will be used whenadding a new object to your application.

Examplejob-descriptions, data-areas, user's spaces, etc.

1The categorized designation for the sorts of objects.



ARCAD-Server v10.09.xx11 Manage clean up and debugging | Configuration Guide

11 Manage clean up and debugging

The cleanup and debugging processes aremanaged from the Installation/Parameter Menu (command:I_ARCAD).

11.1 Running the clean up procedures

Selecting option 14 Clean-up procedures enables you to run the ARCLNUP command.

11.2 Configuring automatic program bug recovery

Option 15 Retrieval of program errors enables you to implement the automatic retrieval of informationfor program errors.

When a program "crashes", a warning screen fromwhich you can open a new incident report1 is displayed.This method executes theRTVBUG macro in which you can specify the processing of your choice.

As part of this implementation, the following is executed for 2message descriptions:

CHGMSGD MSGID (XXX9001) … DFTPGM (ARCAD_PRD/AARM421C1)

Where XXX represents the code for the language(s) that you use (RPG for RPG and/or CBE for COBOL).

For CL programs, it is necessary to run the same command but on the following messages:

l CPF0001l CPF9999

Given that these are systemmessages, the changed parameters could be reset when the OS is upgraded.

This function handles possible access conflicts (record locks) not managed in your applications. In this case,a window notifying you of the conflict with another user is displayed.

11.3 Configuring the debugging tool

Option 17Debugging tool enables you to configure the debugging tool. You can use the standard IBMproducts (STRDBG, STRISDB) or VISUAL from Tango/04.

1(IR) A user document produced to report an incident detected when running an application.



ARCAD-Server v10.09.xxConfiguration Guide | 12 Grant access to IFS user objects

12 Grant access to IFS user objects

Access to IFS1 user objects must be granted. Profiles are granted this access from theWork with IFS UserObject Autmenu, which can be accessed by selecting option 18 from the Installation/Parameter Menu(command: I_ARCAD).

The commands AWRKIFSUSE and ADSPIFSUSE also allow you access to this menu and to work with theaccess authority for the command AUSEIFSOBJ, which enables you to use PC commands (Windows) on IFSobjects.

All users have browse access to the ADSPIFSUSE command. However, for the command AWRKIFSUSE, theauthority is managed as follows:

1. If the profile is the ARCAD Administrator, they must have the authority to manage all applications inaddition to the default authority.

2. If the profile is an application manager2 on some applications, they can only work with the setup ofthose specified applications. They may copy the setup parameters of another application to theirs, butnot export. However they may not modify the general parameters (other than those for applications).

3. If the profile is neither ARCAD admin nor an application manager, then they may only view the setupparameters (option 3 Copy is still be available but has no copy destination).

Use the fields in the first menu to define the scope of the profiles to view/edit.

Application ID (APP) Indicates the application to process. The possible values are:

l *CURENV is the application corresponding to the current environment3 that is used by default.l *SELECT allows you to select the application that you wish to process from a list. This value allows youto viewwhich applications have been declared.

l *NONE displays only the rights defined by default in an application.l You can enter an existing Application-ID.

User profile (USER) Allows you to enter which user profiles to view. The possible values are:

l *ALL The authority defined for all the profiles will be displayed.l user Only the specified user profiles authorities are displayed.l *CURRENTOnly the current user profiles authorities are displayed.l *PUBLIC Only *PUBLIC authorities are displayed.

IFS Object Authority (ATR) Allows you to select certain attributes and not others. The possible valuesare:

l *ALL No selection is made by attribute.l attribute Only the authority concerning the specified attribute is displayed.

Utilization option (OPTION) Allows you to select only certain options and not others. The possible valuesare:

1Integrated File System2A user. The user/profile responsible for the correct functioning of the application in relation to the users.3The environment in the context of which a programmer works.



ARCAD-Server v10.09.xx12 Grant access to IFS user objects | Configuration Guide

l *ALL No selection is carried out on the use options.l option Only those rights corresponding to the option indicated are displayed.

When the scope is defined, press enter to access theWork with IFS usage authoritymenu where you canview, edit, copy, add and/or delete IFS user parameters.



ARCAD-Server v10.09.xxConfiguration Guide | 13 Reinitialize

13 Reinitialize

Selecting option 21 Initializing from the Installation/Parameter Menu (command: I_ARCAD) enables youto restore ARCAD definitions by reinitializing the ARCAD database.



ARCAD-Server v10.09.xxIndex | Configuration Guide


- C -Commands

AADDAPPVAR 26ACPLOBJ 33, 51ADSPIFSUSE 54AEDTDTAARA 27ALCKOBJ 44ARCRDOC 23ARIRDOC 23ASNDRMTCMD 22AUSEIFSOBJ 54AWRKAPP 50AWRKAPPVAR 25AWRKIFSUSE 54AWRKOBJARC 45, 49AWRKSIT 24AWRKSRCTYP 50AWRKUSR 24CHGCMDDFT 48CHGSYSLIBL 11-12CHGUSRPRF 16CMD-AMSGCMDE 22CPYSRCF 13CRTUSRPRF 15I_ARCAD 4, 14-15, 22-23, 27, 48, 50, 53-54,

56QSYSLIBL 11-12RMVM 13RNMM 13STRSDA 12STRSEU 12USROPT 49WRKDIRE 22

- I -IFS 54

- L -Libraries

ARCAD_PRD 11, 53library 11-12, 27, 50

library list 11-12, 45

- M -Macro Commands

ARCLNUP 42, 53

- P -Profiles

ARCxx_NET 22, 42QSECOFR 18


arcad-server 10.09.xx configuration guide · northamerica&latam emea(hq) asiapacific...

Documents