IBM AS/400 manual Managing Activation Groups, Specifying an Activation

Managing Activation Groups

programs activated within one activation group are developed as one co application.

You identify the activation group that

your ILE program will run in at

program creation. The activation group is

determined

by

the

value

spec

ACTGRP

parameter when

the

program object

was created. (OPM programs alw

run in the default activation group; you

cannot

change their

activation

cation.)

Once

an

ILE

program (object

type *PGM)

is

activated,

it

remain

until

the

activation

group

is

deleted.

The

remainder

of

this section

tells

you

how to

specify

an

activation

to delete one.

For

more

information on activationILEgroups,Concepts.refer to

Specifying an Activation

Group

You

control

that activation

group

your

ILE

program

will

run

in

by speci

for

the

ACTGRP

parameter

when

you

create

your program

(using

CRTPGM

or

CRTBNDRPG)

or

service

program

(using CRTSRVPGM).

Note:

If

you

are

using

the

CRTBNDRPG

command, you

can

only

specify

a v

for

ACTGRP

if

the

value

of

DFTACTGRP is

*NO.

You can choose one of the following values:

¹ a named activation group

A named		activation		group allows you to manage a collection of		ILE pro
and	service		programs as one application. The activation		group	is	cre
the	first		program that specified the activation group		name	on	crea
It	is	then	used	by all programs and service programs	that	specify

activation group name.

A named activation group ends when it is deleted using the CL comman RCLACTGRP. This command can only be used when the activation group is longer in use. When it allis resourcesnded, associated with the programs and service programs of the named activation group are returned to system.

The named activation group QILE is the default value of the ACTGRP eter on the CRTBNDRPG command. However, because activation groups are intended to correspond to applications, it is recommended that you different value for this parameter. For example, you may want to n vation group after the application name.

¹*NEW

When *NEW is specified, a new activation group is created whenever program is called. The system creates a name for the activation gr name is unique within your job.

An activation

group

created with *NEW

always

ends when

the program(s)

ciated

with

it

end. For this reason, if you plan

on

returning

from

with

LR

OFF

in

order to keep your program active,

then

you

should

*NEW

for

the

ACTGRP

parameter.

Note:

This value

is not valid for service programs.

A

service

program

run

in

a

named activation group

or the

activation

group

of

its

*NEW is the default value for the ACTGRP parameter on the CRTPGM command.

110 ILE RPG for AS/400 Programmer's Guide