docs.datacontroller.io/docs/formats.md

---
layout: article
title: API
description: Viewing and Modifying SAS Format Catalogs in Data Controller
---

# Formats

Data Controller allows formats to be viewed and edited directly from the web interface - avoiding the need to create and maintain parallel 'CNTLIN' datasets.

Formats are displayed with a special icon (`bolt`), in the same library as other tables (in both the VIEW and EDIT screens):

![formats](img/formats.png)

Viewing or editing a format catalog will always mean that the entire catalog is exported, before being filtered (if filters applied) and displayed.  For this reason, it is recommended to split a large format catalog over several catalogs, if performance is a consideration.

The usual export mechanisms can also be applied - you can downlad the DDL, or export the catalog in CSV / Excel / Datalines / Markdown / DDL formats.

When adding a format to MPE_TABLES, the `DSN` should contain the format catalog name plus a `-FC` extension.  The LOADTYPE should be `FORMAT_CAT` and the BUSKEY should be `FMTNAME START`.  HOOK scripts can also be applied (ie, run some DQ after an edit, or re-run a batch job after an approval).

Example:

|LIBREF:$8.|DSN:$32.|LOADTYPE:$12.|BUSKEY:$1000.|
|---|---|---|---|
|`MYLIB `|`FORMATS-FC `|`FORMAT_CAT `|`FMTNAME START `|

Just like regular table edits, all changes to formats are logged in the `MPE_AUDIT` table.
feat: formats plan 2022-01-27 19:59:42 +00:00			`---`
			`layout: article`
			`title: API`
fix: format image 2022-02-27 21:59:51 +00:00			`description: Viewing and Modifying SAS Format Catalogs in Data Controller`
feat: formats plan 2022-01-27 19:59:42 +00:00			`---`

			`# Formats`

fix: format image 2022-02-27 21:59:51 +00:00			`Data Controller allows formats to be viewed and edited directly from the web interface - avoiding the need to create and maintain parallel 'CNTLIN' datasets.`
feat: formats plan 2022-01-27 19:59:42 +00:00
fix: update to include formats and special SAS missing numerics in the docs 2022-02-27 19:37:35 +00:00			Formats are displayed with a special icon (`bolt`), in the same library as other tables (in both the VIEW and EDIT screens):
feat: formats plan 2022-01-27 19:59:42 +00:00
fix: format image 2022-02-27 21:59:51 +00:00			`![formats](img/formats.png)`
feat: formats plan 2022-01-27 19:59:42 +00:00
fix: update to include formats and special SAS missing numerics in the docs 2022-02-27 19:37:35 +00:00			`Viewing or editing a format catalog will always mean that the entire catalog is exported, before being filtered (if filters applied) and displayed. For this reason, it is recommended to split a large format catalog over several catalogs, if performance is a consideration.`
feat: formats plan 2022-01-27 19:59:42 +00:00
Update formats.md 2022-08-15 10:09:43 +00:00			`The usual export mechanisms can also be applied - you can downlad the DDL, or export the catalog in CSV / Excel / Datalines / Markdown / DDL formats.`
feat: formats plan 2022-01-27 19:59:42 +00:00
fix: format image 2022-02-27 21:59:51 +00:00			When adding a format to MPE_TABLES, the `DSN` should contain the format catalog name plus a `-FC` extension. The LOADTYPE should be `FORMAT_CAT` and the BUSKEY should be `FMTNAME START`. HOOK scripts can also be applied (ie, run some DQ after an edit, or re-run a batch job after an approval).
feat: formats plan 2022-01-27 19:59:42 +00:00
Update formats.md 2022-08-15 09:57:33 +00:00			`Example:`

			`\|LIBREF:$8.\|DSN:$32.\|LOADTYPE:$12.\|BUSKEY:$1000.\|`
			`\|---\|---\|---\|---\|`
			\|`MYLIB `\|`FORMATS-FC `\|`FORMAT_CAT `\|`FMTNAME START `\|

Update formats.md 2022-08-15 09:58:00 +00:00			Just like regular table edits, all changes to formats are logged in the `MPE_AUDIT` table.