{"audience":"BASIS administrators, and project and support teams rebuilding the job schedule after a go-live or system copy.","authorization_objects":[{"note":"Create and release jobs in the job group (RELE)","object":"S_BTCH_JOB"},{"note":"Run a step under another user name","object":"S_BTCH_NAM"},{"note":"Delete and change jobs of other users","object":"S_BTCH_ADM"}],"components":[],"countries":[],"effort_days_max":5,"effort_days_min":3,"effort_size":"S","faq":[{"a":"Yes, an export option in the same template can be added: released periodic jobs in the source system are written to a file, edited and loaded in the target system. This takes about one extra day.","q":"Can I export the current job plan and load it into another system?"},{"a":"The basic template covers time-based starts. By adding event ID and parameter columns to the file, event-triggered jobs can also be scheduled with JOB_CLOSE; predecessor job chains can be added the same way.","q":"Can event-triggered jobs be scheduled as well?"},{"a":"Yes. Columns for printer, print immediately and spool list recipient per step can be added; JOB_SUBMIT supports these print parameters.","q":"Can spool recipients or print parameters be provided?"}],"features":[{"code":"test_run","label":"Test mode (check without posting)","note":"Test mode runs program, variant, user and time checks without creating jobs."},{"code":"alv","label":"ALV list (sort, filter, subtotals)","note":""},{"code":"log","label":"Line-by-line result and error log","note":""},{"code":"error_file","label":"Download failed lines as a separate file","note":"Failed rows can be downloaded in the same template, corrected and uploaded again."},{"code":"drilldown","label":"Double-click drill-down to the document","note":"Double-clicking the job name opens SM37."}],"functions":[{"name":"JOB_OPEN","role":"Opens a new background job and returns the job count"},{"name":"JOB_SUBMIT","role":"Adds a step with program, variant and step user to the job"},{"name":"JOB_CLOSE","role":"Sets start time, period and target server, closes and releases the job"},{"name":"BP_JOB_READ","role":"Reads existing jobs with the same name"},{"name":"BP_JOB_DELETE","role":"Deletes the old scheduled job when the replace option is on"}],"gap":"SM36 defines jobs one by one, step by step on the screen; setting up hundreds of periodic jobs from a list takes hours and is prone to typos. After a system copy, BTCTRNS1/BTCTRNS2 only suspend and release existing jobs; they do not load a new job plan. This program loads the approved job plan list directly and keeps the result of each row in a log.","id":"basis-mass-background-job-scheduling-upload","industries":[],"input_columns":[{"derived":false,"label":"Job name","required":true,"rule":"","target_field":"JOBNAME","target_table":"TBTCO"},{"derived":false,"label":"Job class","required":false,"rule":"","target_field":"JOBCLASS","target_table":"TBTCO"},{"derived":false,"label":"Program","required":true,"rule":"","target_field":"PROGNAME","target_table":"TBTCP"},{"derived":false,"label":"Variant","required":false,"rule":"","target_field":"VARIANT","target_table":"TBTCP"},{"derived":false,"label":"Step user","required":true,"rule":"","target_field":"AUTHCKNAM","target_table":"TBTCP"},{"derived":false,"label":"Start date","required":true,"rule":"","target_field":"SDLSTRTDT","target_table":"TBTCO"},{"derived":false,"label":"Start time","required":true,"rule":"","target_field":"SDLSTRTTM","target_table":"TBTCO"},{"derived":false,"label":"Period (days)","required":false,"rule":"","target_field":"PRDDAYS","target_table":"TBTCO"},{"derived":false,"label":"Period (hours)","required":false,"rule":"","target_field":"PRDHOURS","target_table":"TBTCO"},{"derived":false,"label":"Period (months)","required":false,"rule":"","target_field":"PRDMONTHS","target_table":"TBTCO"},{"derived":false,"label":"Target server","required":false,"rule":"","target_field":"EXECSERVER","target_table":"TBTCO"}],"kind":"program","language":"en","lastmod":"2026-11-17","logic":"1. The file is read; consecutive rows with the same job name are grouped as steps of one job.\n2. Checks: the program exists in TRDIR and is executable (SUBC = 1); the variant exists in VARID; the step user exists in USR02, is not locked and has an allowed type (default: system or service user); the start time is not in the past.\n3. Depending on the selection, scheduled (P) or released (S) jobs with the same name are found with BP_JOB_READ and deleted with BP_JOB_DELETE if the replace option is on; otherwise the row is skipped.\n4. In test mode only the check results are listed. In a real run the job is opened with JOB_OPEN and each step is added with JOB_SUBMIT with program, variant and step user.\n5. JOB_CLOSE sets the start date/time, the period (minutes, hours, days, weeks, months) and the target server; depending on the selection the job is released immediately or left as scheduled.\n6. The result is shown per row in ALV: job count, status and message; double-clicking the job name opens SM37.","module":"BASIS","object_type":"upload","output_columns":[{"calculated":true,"formula":"Row number in the file","label":"Row","source_field":null,"source_table":null},{"calculated":false,"formula":"","label":"Job name","source_field":"JOBNAME","source_table":"TBTCO"},{"calculated":false,"formula":"","label":"Job count","source_field":"JOBCOUNT","source_table":"TBTCO"},{"calculated":false,"formula":"","label":"Program","source_field":"PROGNAME","source_table":"TBTCP"},{"calculated":false,"formula":"","label":"Variant","source_field":"VARIANT","source_table":"TBTCP"},{"calculated":false,"formula":"","label":"Step user","source_field":"AUTHCKNAM","source_table":"TBTCP"},{"calculated":false,"formula":"","label":"Planned start","source_field":"SDLSTRTDT","source_table":"TBTCO"},{"calculated":false,"formula":"","label":"Job status","source_field":"STATUS","source_table":"TBTCO"},{"calculated":true,"formula":"Created / Replaced / Test / Skipped / Error","label":"Result","source_field":null,"source_table":null},{"calculated":true,"formula":"Check or job function message","label":"Message","source_field":null,"source_table":null}],"parameters":[{"example":"C:\\temp\\is_plani.xlsx","kind":"parameter","label":"Job plan file (XLSX or CSV)","name":"P_FILE","ref_field":"","required":true},{"example":"X","kind":"checkbox","label":"Test mode (check without creating jobs)","name":"P_TEST","ref_field":"","required":false},{"example":"X","kind":"checkbox","label":"Release jobs immediately","name":"P_RELEA","ref_field":"","required":false},{"example":"","kind":"checkbox","label":"Replace scheduled jobs with the same name","name":"P_REPL","ref_field":"","required":false},{"example":"B, S","kind":"select_option","label":"Allowed step user types","name":"S_USTYP","ref_field":"USR02-USTYP","required":false}],"part_of":["basis-daily-system-check-pack"],"performance":"Job creation is fast; a few hundred jobs are set up in under a minute. Read the checks once for the distinct programs, variants and users in the file. On a production system, always use test mode and an approved job plan before the real run.","quote_url":"https://nekuhub.com/en/request-a-quote/?report=basis-mass-background-job-scheduling-upload","related":["basis-background-jobs-personal-users","basis-cancelled-long-running-jobs"],"releases":[],"source":"custom","standard_alternatives":[{"note":"Defines jobs one by one on screen; no bulk scheduling from a file or pre-checks.","tcode":"SM36"},{"note":"Monitors and changes scheduled jobs; it does not load a new job plan.","tcode":"SM37"}],"summary":"A custom program that schedules dozens of background jobs in one go from an Excel file after a go-live, a system copy or the opening of a new company code, with program, variant, step user, start time and period. Rows with the same job name are created as a multi-step job; program, variant and user are checked in advance, and no job is created in test mode.","tables":[{"access":"write","join_on":"","role":"Job header; created through JOB_OPEN and JOB_CLOSE","table":"TBTCO","variant":"both"},{"access":"write","join_on":"TBTCP-JOBNAME = TBTCO-JOBNAME AND TBTCP-JOBCOUNT = TBTCO-JOBCOUNT","role":"Job steps; added through JOB_SUBMIT","table":"TBTCP","variant":"both"},{"access":"read","join_on":"TRDIR-NAME = TBTCP-PROGNAME","role":"Check of program existence and type","table":"TRDIR","variant":"both"},{"access":"read","join_on":"VARID-REPORT = TBTCP-PROGNAME AND VARID-VARIANT = TBTCP-VARIANT","role":"Existence check for the variant","table":"VARID","variant":"both"},{"access":"read","join_on":"USR02-BNAME = TBTCP-AUTHCKNAM","role":"Type and lock status of the step user","table":"USR02","variant":"both"}],"title":"Mass Background Job Scheduling from Excel","url":"https://nekuhub.com/en/programs/mass-background-job-scheduling-from-excel/","vendor_id":"nekudos"}