Category: BRMS

ENDSBS *ALL ALTERNATIVE

1. SNDBRKMSG to warn all users to sign-off due to Backup in 10 minutes

2. ENDSBS QINTER, QBATCH, QSERVER with OPTION(*CNTRLD) DELAY(*NOLIMIT)

3. After 10 minutes, ENDHOSTSVR SERVER(*ALL)

4. ENDTCP

5. ENDSBS QCMN, QINTER, QBATCH, QSERVER with OPTION(*IMMED) using CPF1054

6. After 5 minutes, start the backup.

7. Restart QCMN, QINTER, QSERVER, & TCP/IP

8. After the backup, restart QBATCH

This assumes that:

1. The procedure is either run from the console, or from a custom batch subsystem and job queue (external from QBATCH subsystem/jobq).

2. All memory resident programs check for the end-job status flag.

3. There are no other active batch or interactive subsystems. Steps 3, 4, & 5 will definitely kick out everyone but the console operator. Step 7 will allow people to connect/signon and initiate some jobs that may interfere with the backup. To remove this possibility, you could interchange steps 7 and 8. However, it is my experience that you should allow people to connect so that in case anything goes wrong, the technical staff can still get in to fix it remotely. You could opt to insert an initial sign-on program into your non-technical users’ user profiles to check if the backup is in progress, and if so, bar them with an informative message.

Start Backup using BRM (STRBKUBRM)

Send feedback

Where allowed to run: All environments (*ALL)
Threadsafe: No

Parameters
Examples
Error messages

The Start Backup using BRM (STRBKUBRM) command selects a control group to back up. You can start the backup immediately or you can schedule it using the system job scheduler. Processing can be batch or interactive.

To use this command, you must have the Backup Recovery and Media Services for IBM i licensed program installed.

Restrictions:

This command should not be used by control group *EXIT item processing as results will be unpredictable.
You must have *USE authority to backup item exit programs and *EXECUTE authority to libraries containing the backup item exit programs.

Keyword	Description	Choices	Notes
CTLGRP	Control group	Name, BKUGRP, SYSGRP, *SYSTEM	Required, Positional 1
SCDTIME	Schedule time	Decimal number, *IMMED	Optional
SBMJOB	Submit to batch	YES, CONSOLE, CTLSBS, NO	Optional
STRSEQ	Starting sequence	Element list	Optional
	Element 1: Number	1-9999, *FIRST
	Element 2: Library	Name, *FIRST
APPEND	Append to media	CTLGRPATR, BKUPCY, NO, YES	Optional
JOBD	Job description	Single values: USRPRF Other values: Qualified object name*	Optional
	Qualifier 1: Job description	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
JOBQ	Job queue	Single values: JOBD Other values: Qualified object name*	Optional
	Qualifier 1: Job queue	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
ACTIVITY	Activity	CTLGRPATR, FULL, *INCR	Optional
RETENTION	Retention	Element list	Optional
	Element 1: Retention type	CTLGRPATR, DAYS, *PERM
	Element 2: Retain media	1-9999, 35
DEV	Device	Values (up to 4 repetitions): Name, CTLGRPATR, MEDCLS	Optional
PRLRSC	Parallel device resources	Element list	Optional
	Element 1: Minimum resources	1-32, CTLGRPATR, NONE, *AVAIL
	Element 2: Maximum resources	1-32, MIN, AVAIL
MEDCLS	Media class	Character value, CTLGRPATR, SYSPCY	Optional
MOVPCY	Move policy	Name, CTLGRPATR, NONE	Optional
OMITS	Omits	PROCESS, IGNORE	Optional

Parameters

Control group (CTLGRP)

Schedule time (SCDTIME)

Submit to batch (SBMJOB)

Starting sequence (STRSEQ)

Append to media (APPEND)

Job description (JOBD)

Job queue (JOBQ)

Activity (ACTIVITY)

Retention (RETENTION)

Device (Dev)

Parallel device resources (PRLRSC)

Media class (MEDCLS)

Move policy (MOVPCY)

Omits (OMITS)

Examples

Error messages

CL command finder