8 1 2 Create PC Definitions

LANSA for i

8.1.2 Create PC Definitions

To create new PC definitions, use the Add/Create function key on the Work with PC Definitions screen.

This will cause the Create PC Definition screen to be displayed.

 

 

   DC@P642103                Create PC Definition                    

 

 

  PC Name  . . . . . . . . . . . . . .   ____________                 

  PC Description . . . . . . . . . . .   ____________________________ 

 

  Data Queue In  . . . . . . . . . . .   ____________                 

  Data Queue Out . . . . . . . . . . .   ____________                 

  Monitor Program                                                   

    Job Description  . . . . . . . . .   *LIBL/QBATCH                 

    Job Queue  . . . . . . . . . . . .   *LIBL/QINTER                

    Output Queue . . . . . . . . . . .   *LIBL/QPRINT                 

  Translation                                                       

    Table In . . . . . . . . . . . . .   QSYS/ANSEBC1140             

    Table Out  . . . . . . . . . . . .   QSYS/QASCII                  

  Submitted Jobs                                                    

    Job Description  . . . . . . . . .   *LIBL/QBATCH                 

    Job Queue  . . . . . . . . . . . .   *LIBL/QBATCH                 

    Output Queue . . . . . . . . . . .   *LIBL/QPRINT           More..

 

  F1=Help  F3=Exit  F14=Messages                                    

 

 

 

The details on the Create PC Definition screen should be entered or modified according to these guidelines:

PC NameMust be a valid IBM i name. This is the node name that you gave your PC when Visual LANSA was installed.

PC Description

A brief description for the PC.

Data Queue In & Out

The name you specify for "Data Queue In" or "Data Queue Out" is used to form the name of an IBM i library. The name is formed by appending the letters _DQL to the name you specify. The resulting name is then truncated to form at most a 10 character IBM i library name.

Thus, if you specify TESTIN, the resulting library name would be TESTIN_DQL. If you specify name TESTWORK then the resulting name would be TESTWORK_D. If you specify name TESTWORKIN then the resulting library name would be TESTWORKIN.

The portion of any queue library name that you specify:

  • Must be different to any other input or output queue name already specified for any other workstation (including the one that you are currently defining).
  • Must be a valid IBM i object name.

The library name (and the required objects within it) will be automatically created and initialized when the workstation starts a Host Monitor session or when you next do a LANSA database REORG operation.

Generally the libraries do not need to be backed up.

If the queues within the library become unusable you can rectify the problem by:

  • Running a LANSA database REORG

or

  • Shutting down the Host Monitor of the workstation involved, clearing or deleting the libraries and then restarting the Host Monitor.

Either of these solutions will of course lose any information currently held in the queues within the libraries.

Monitor Program

The Job Description, Job Queue and Output Queue entered here will be the ones used for the LANSA Host Monitor Program to run. They must be entered in IBM i format.

Translation Table In

This is the table used by LANSA to translate data received from the PC (ASCII) to the format used on the IBM i (EBCDIC).

If you are creating multilingual applications please read the Note for All Users regarding this entry.

Translation Table Out

This is the table used by LANSA to translate data from the format used on the IBM i (EBCDIC) to the format used on the PC (ASCII).

If you are creating multilingual applications please read the Note for All Users regarding this entry.

Submitted Jobs

The Job Description, Job Queue and Output Queue entered here will be the ones used by the LANSA Host Monitor Program to submit jobs. They must be entered in IBM i format.

After entering the details, 'page down' should be pressed to display the second part of the screen.

 

   DC@P642103                Create PC Definition                

 

 

      Allowable Partitions . . . . . . . .                 

 

 

 

 ___    ___    ___    ___    ___    ___    ___    ___    ___    ___  

 ___    ___    ___    ___    ___    ___    ___    ___    ___    ___  

 ___    ___    ___    ___    ___    ___    ___    ___    ___    ___  

 ___    ___    ___    ___    ___    ___    ___    ___    ___    ___  

 ___    ___    ___    ___    ___    ___    ___    ___    ___    ___  

 

 

 

 

 

   F1=Help  F3=Exit  F14=Messages        

 

 

 

Allowable Partitions

This screen allows the specification of partitions allowed for the PC to sign on to. Enter up to 50 unique identifiers to allow access to these partitions. If the PC tries to sign on to a partition that is not specified here, the LANSA Host Monitor job on the IBM i will terminate.

After pressing Enter, the data will be stored on file. At the same time, the inbound and outbound libraries of data queues are created. Also, a data area with the same name as the inbound data queue library is created. These three sets of objects are required for running the LANSA Host Monitor.